发送价格查询

接口概述

接口说明

查询账户国际短信按国家划分的发送单价信息。

节点域名

归属节点查询操作指引

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

基础信息

• 接口地址：

  • 上海节点：https://intapi.tig253.com/intsms/v2/prices/getlist
  • 新加坡节点：https://sg-intapi.tig253.com/intsms/v2/prices/getlist
  • 印尼节点：https://id-api.tig253.com/intsms/v2/prices/getlist

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

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

• 编码格式：UTF-8

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

注意事项

1. 请求体 countryCode 为选填参数，不传默认返回全国家价格数据

2. 国家码必须保留前缀 00，例中国大陆填写 0086

3. 账号通过请求头 AppID 获取，请求体无需传递账号信息

4. 请求时间戳有效期 5 分钟，超时返回 120504

5. 每次请求务必重新生成 Nonce 随机串与 CheckSum 签名

6. 签名校验失败返回 120001

7. 自定义请求头 X-Custom-TraceId 可作为全局请求唯一交易 ID

接口请求

请求体参数（Body）

请求示例

复制成功⧉
POST /intsms/v2/prices/getlist HTTP/1.1
Host: api.xxx.com
Content-Type: application/json;charset=utf-8
AppID: APP_xxxx
Nonce: a8f3d92cb1
CurTime: 1748419200
CheckSum: A1B2C3D4E5F67890
X-Custom-TraceId: trace_2026052912514

{
  "countryCode": "0086"
}

接口响应

响应字段说明

响应示例

成功响应

复制成功⧉
{
  "code": "000000",
  "msg": "success",
  "requestId": "20260527150000xxxx",
  "data": [
    {
      "countryName": "中国",
      "countryCode": "0086",
      "settleCurrency": "CNY",
      "settleUnitPrice": 0.045,
      "accountSendPricelist": [
        {
          "countryCode": "0086",
          "carrier": "中国移动",
          "settleUnitPrice": 0.045,
          "settleCurrency": "CNY"
        },
        {
          "countryCode": "0086",
          "carrier": "中国联通",
          "settleUnitPrice": 0.046,
          "settleCurrency": "CNY"
        }
      ]
    }
  ]
}

签名失败响应

复制成功⧉
{
  "code": "120001",
  "msg": "signature verification failed"
}

错误码汇总说明

---