获取上行回复接口
用于获取用户回复的短信内容
接口说明
本接口用于获取用户回复的短信内容(上行短信)。相同的上行回复，只能获取一次。
接口地址
POST http://cloud.thinksms.cn/callApi.aspx
Content-Type: application/x-www-form-urlencoded
请求参数
| 参数名称 | 含义 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| action | 请求动作 | string | 是 | 固定为:query |
| userid | 企业ID | string | 是 | 企业ID（登陆后台-客户管理-我的信息） |
| account | 帐号 | string | 是 | 短信帐号 |
| password | 密码 | string | 是 | 登陆密码 |
| ownExt | 使用自有扩展号 | string | 否 | 可不填或为空。当该值为1时，返回的extno将剔除系统强制附加的子号，为客户自己提交的子号，前提是上级通道支持时。 |
| rt | 返回格式 | string | 否 | 固定值：json，不填则为XML格式返回 |
请求示例
JSON格式请求：
http://cloud.thinksms.cn/callApi.aspx?action=query&rt=json&userid=企业ID&account=账号&password=密码
响应数据
JSON格式响应：
{
"ReturnStatus": "Success",
"Message": "OK",
"Task": [
{
"Mobile": "136",
"TaskID": "1",
"Content": "test",
"ReceiveTime": "2018-12-07 15:17:26",
"ExtNo": "251251"
},
{
"Mobile": "136",
"TaskID": "1",
"Content": "test",
"ReceiveTime": "2018-12-07 15:17:26",
"ExtNo": "251251"
}
]
}
字段说明
ReturnStatus 返回状态值：成功返回Success，失败返回：Faild
Message 描述信息
Task 上行数组队列
Mobile 对应的手机号码
TaskID 同一批任务ID
Content 上行内容
ReceiveTime 接收时间
ExtNo 子号，即自定义扩展号
错误返回值
{
"ReturnStatus": "Faild",
"Message": "用户名或密码错误"
}
注意事项
-
上行回复获取限制
相同的上行回复，只能获取一次。建议定期获取上行回复以避免数据丢失。
-
获取频率
建议每5-10分钟获取一次上行回复，避免频繁请求对系统造成压力。
-
内容处理
上行内容可能包含用户输入的各种字符，请确保您的系统能够正确处理特殊字符和编码，做好防注入处理。
-
自有扩展号
当ownExt参数为1时，返回的extno将剔除系统强制附加的子号，仅显示客户自己提交的子号，前提是上级通道支持此功能。
