-
基础知识
-
平台操作流程
-
API接口
-
状态码
-
调用接口实例
技术服务
API接口
短信状态报告查询接口（MTQuery）
接口定义
接口名称 短信状态报告查询接口 由第三方平台主动发起请求向平台获取结果 请求内容 INDEX： http://ip:port/api/v2/sms/query 或者https://ip:port/api/v2/sms/query BODY：&userid=用户编号&ts=1476235100217&sign=md5(userid + ts + apikey) 完 整 URL 实 例 ， 如 ： http://ip:port/api/v2/sms/query?userid=100001&ts=1476235100217&sign=b3ac538457234fed842ed5f06c87f03a请求方法 GET 应答方式 JSON 接口协议 HTTP
输入参数
字段名称 说明 数据类型 长度 userid 用户编号，接入方信息唯一标识 String 用户在平台上分配的用户编号 ts 时间戳, 5 分钟内有效, 时间戳是指格林威治时间 1970年 01 月 01 日 00 时 00 分 00 秒起至现在的总毫秒数 Long System.currentTi meMillis()sign 三个信息字符串拼接，然后md5 算法加密 （MD5 用32 位，值必须要小写进行加密） md5(userid + ts + apikey) 中间无需空格、无需+号String apikey:由系统分配
输出参数
字段名称 说明 数据类型 长度 code 状态码 String 10 msg 状态描述 String 50 data 数据节点 Object taskid 任务ID,关联MT 接口返回的taskid String 32 code 状态码 String 10 msg 状态描述 String 50 mobile 用户手机号码，如：13505710000 String 11 time 接收时间，需要按yyyyMMddHHmmss 格式，如：20110115105822 String 14
特别说明：每次查询最多返回 200 条
参数示例
调用正常有数据：
{
"code": "0",
"msg": "成功",
"data": [
{
"time": "20161222015900",
"taskid": "T1222015900000109761866",
"code": "DELIVRD",
"msg": " 成 功 ",
"mobile": "13505718888"
},
{
"time": "20161222015901",
"taskid": "T1222015900000109761867",
"cod e": "DELIVRD",
"msg": "成功",
"mobile": "13505718889"
}
]
}
调用正常无数据:
{
"code": "0",
"msg": "成功"
}
调用异常:
{
"code": "4",
"msg": "用户不存在"
}
