消耗查询
更新时间：2026-07-31 09:59:53
接口概述
接口说明
查询账户国际短信每日消耗数据。
节点域名
| 节点 | 域名 |
|---|---|
| 上海节点 | intapi.tig253.com |
| 新加坡节点 | sg-intapi.tig253.com |
| 印尼节点 | id-api.tig253.com |
归属节点查询操作指引
💡 重要提示：请根据控制台账号归属节点，选择对应节点域名拼接接口地址
基本信息
-
接口地址：
https://节点域名/intsms/v2/fee/getlist -
Content-Type：
application/json;charset=utf-8 -
请求方式：POST，请求体为 JSON 格式封装的字符串
-
编码格式：UTF-8
完整公共请求头、CheckSum 验签算法统一参考：API调用说明
接入指南
注意事项
-
请求体必传 startDate、endDate 日期参数
-
账号通过请求头 AppID 获取，请求体无需传递
-
查询时间区间最大间隔 30 天
-
起止日期禁止选择当日，仅可查历史日期
-
请求时间戳有效期 5 分钟，超时返回 120504
-
每次请求务必重新生成 Nonce 随机串与 CheckSum 签名
-
签名校验失败返回 120001
-
自定义请求头 X-Custom-TraceId 可作为全局请求唯一交易 ID
接口请求
请求体参数（Body）
| 参数名 | 类型 | 必填 | 格式说明 |
|---|---|---|---|
| startDate | string | 是 | 开始日期 yyyy-MM-dd |
| endDate | string | 是 | 结束日期 yyyy-MM-dd |
| productType | string | 是 | 短信类型：notify（验证码）、market（营销/通知） |
请求示例
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 | string | 响应状态码 |
| msg | string | 响应描述信息 |
| requestId | string | 平台生成唯一请求 ID |
| data | array | 每日消耗数据集合 |
| data[].account | string | 业务账号 |
| data[].pttDay | string | 统计日期 |
| data[].costTotal | string | 当日短信消耗金额 |
响应示例
成功响应
{
"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"
}统一错误码汇总
参考通用状态码
| 状态码 | 错误说明 |
|---|---|
| 000000 | 请求成功 |
| 120001 | 签名校验失败 |
| 120504 | 时间戳超出 5 分钟有效期 |
| 190004 | INVALID_PARAMETER 参数错误 |
| 202301 | DATE_RANGE_EXCEEDED 查询时间超过 30 天 |
| 202302 | QUERY_TODAY_DATA_FORBIDDEN 不允许查询当日数据 |
这篇文档对您有帮助吗？
