余额查询

接口概述

接口说明

国际短信账户余额查询，用于查询当前国际短信账号的可用余额，帮助判断是否有足够余额继续发送短信。

节点域名

归属节点查询操作指引

💡 重要提示：请根据控制台账号归属节点，选择对应节点域名拼接接口地址

基本信息

• 请求地址：https://节点域名/intsms/v2/balance/getinfo

• Content-Type：application/json;charset=utf-8

• 请求方式：POST，请求体为 JSON 格式封装的字符串

• 编码格式：UTF-8

完整公共请求头、CheckSum 验签算法统一参考：API调用说明

接入指南

注意事项

1. 无请求体参数，账号由来自请求头 AppID 解析

2. 时间戳有效期 5 分钟：服务端收到请求的时间与 CurTime 差值不能超过 5 分钟，超时返回 120504

3. 每次请求必须生成新 Nonce + 新 CheckSum

4. 调用服务器必须与标准 UTC 时间同步，否则极易验签失败

5. 验签失败返回 120001

6. 若携带 X-Custom-TraceId，会作为本次请求唯一交易 ID

接口请求

请求体参数（Body）

请求示例

POST intsms/v2/balance/getinfo HTTP/1.1
Host: shturl.cc/B
Content-Type: application/json;charset=utf-8
AppID: APP_xxxx
Nonce: a8f3d92cb1
CurTime: 1748419200
CheckSum: A1B2C3D4E5F67890
X-Custom-TraceId: trace_2026052912514

  {
    "productType": "notify"
  }

接口响应

响应体结构

成功响应（code = 000000）

{
  "code": "000000",
  "msg": "success",
  "requestId": null,
  "data": {
    "appId": "your_app_id",
    "account": "your_account",
    "balance": 1250.5
  }
}

失败响应示例

{
  "code": "190004",
  "msg": "productType cannot be empty",
  "requestId": null,
  "data": null
}

响应字段说明

错误码说明