消耗查询

接口概述

接口说明

查询账户国际短信每日消耗数据。

节点域名

归属节点查询操作指引

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

基本信息

• 接口地址：

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

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

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

• 编码格式：UTF-8

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

注意事项

1. 请求体必传 startDate、endDate 日期参数

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

3. 查询时间区间最大间隔 30 天

4. 起止日期禁止选择当日，仅可查历史日期

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

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

7. 签名校验失败返回 120001

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

接口请求

请求体参数（Body）

请求示例

复制成功⧉
POST /intsms/v2/fee/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

{
    "productType": "notify",
    "startDate": "2026-06-01",
    "endDate": "2026-06-20"
  }

接口响应

响应字段说明

响应示例

成功响应

复制成功⧉
{
  "code": "000000",
  "msg": "success",
  "requestId": "20260527150000xxxx",
  "data": [
    {
      "account": "APP_xxxx",
      "pttDay": "2026-06-01",
      "costTotal": "125.50"
    },
    {
      "account": "APP_xxxx",
      "pttDay": "2026-06-02",
      "costTotal": "88.00"
    }
  ]
}

区间超限

复制成功⧉
{
  "code": "202301",
  "msg": "date range exceeds 30 days"
}

查询当日错误

复制成功⧉
{
  "code": "202302",
  "msg": "cannot query today's cost"
}

签名失败

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

统一错误码汇总

参考通用状态码

---