-
基础知识
-
平台操作流程
-
API接口
-
状态码
-
调用接口实例
技术服务
API接口
短信上行查询接口(MOQuery)
接口名称 短信上行查询接口 接口描述 由第三方平台主动发起请求向平台获取结果 请求内容 INDEX: http://ip:port/api/v2/sms/moquery
或者https://ip:port/api/v2/sms/moquery
BODY:&userid=用户编号&ts=1476235100217&sign=md5(userid + ts + apikey)
完 整 URL 实 例 , 如 : http://ip:port/api/v2/sms/moquery?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 id 唯一序列号 String 32 mobile 用户上行手机号码,如:13505710000 String 11 srcid 接收号码,平台提供的接入号 String 21 msgcontent 接收内容,用户上行内容信息 String 140 time 接收时间,需要按yyyyMMddHHmmss 格式, 如:20110115105822) String 14
特别说明:每次查询最多返回 200 条
参数示例
调用正常有数据:
{
"code": "0",
"msg": " 成 功",
"data": [
{
"id": "9d9d0f4d1b864c129e299cc400c26306",
"time": "20161011115655",
"msgcontent": "测试上行短信 1",
"srcid": "1069018889001",
"mobile": "15996480329"
},
{
"id": "9d9d0f4d1b864c129e299cc400c26307",
"time": "20161011115615",
"msgcontent": "测试上行短信 2",
"srcid": "1069018889001",
"mobile": "15996480330"
}
]
}
调用正常无数据:
{
"code": "0",
"msg": "成功"
}
调用异常:
{
"code": "4",
"msg": "用户不存在"
}