发送价格查询
更新时间：2026-07-31 10:00:05
接口概述
接口说明
查询账户国际短信按国家划分的发送单价信息。
节点域名
| 节点 | 域名 |
|---|---|
| 上海节点 | intapi.tig253.com |
| 新加坡节点 | sg-intapi.tig253.com |
| 印尼节点 | id-api.tig253.com |
归属节点查询操作指引
💡 重要提示：请根据控制台账号归属节点，选择对应节点域名拼接接口地址
基础信息
-
接口地址：
https://节点域名/intsms/v2/prices/getlist -
Content-Type：
application/json;charset=utf-8 -
请求方式：POST，请求体为 JSON 格式封装的字符串
-
编码格式：UTF-8
完整公共请求头、CheckSum 验签算法统一参考：API调用说明
接入指南
注意事项
-
请求体 countryCode 为选填参数，不传默认返回全国家价格数据
-
国家码必须保留前缀 00，例中国大陆填写 0086
-
账号通过请求头 AppID 获取，请求体无需传递账号信息
-
请求时间戳有效期 5 分钟，超时返回 120504
-
每次请求务必重新生成 Nonce 随机串与 CheckSum 签名
-
签名校验失败返回 120001
-
自定义请求头 X-Custom-TraceId 可作为全局请求唯一交易 ID
接口请求
请求体参数（Body）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| countryCode | string | 否 | 国家码，固定携带 00 前缀，如 0086 |
请求示例
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 | string | 响应状态码 |
| msg | string | 响应描述信息 |
| requestId | string | 平台生成唯一请求 ID |
| data | array | 国家单价数据列表 |
| data[].countryName | string | 国家中文名称 |
| data[].countryCode | string | 标准国家码 |
| data[].settleCurrency | string | 结算币种 |
| data[].settleUnitPrice | number | 国家统一结算单价 |
| data[].accountSendPricelist | array | 细分运营商价格明细 |
| data[].accountSendPricelist[].countryCode | string | 国家码 |
| data[].accountSendPricelist[].carrier | string | 运营商 |
| data[].accountSendPricelist[].settleUnitPrice | number | 结算单价 |
| data[].accountSendPricelist[].settleCurrency | string | 结算币种 |
响应示例
成功响应
{
"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"
}错误码汇总说明
| 状态码 | 错误说明 |
|---|---|
| 000000 | 请求成功 |
| 120001 | 签名校验失败 |
| 120504 | 时间戳超出 5 分钟有效期 |
这篇文档对您有帮助吗？
