集团客户可通过目标终端发送上行短信给对应的业务平台,其短信格式为:appid#短信内容。 集团客户需在API接入申请的时候同步提交接收上行短信的业务平台ip地址。
参数 | 是否必须 | 默认值 | 格式举例 | 含义 |
---|---|---|---|---|
appid |
是 | 无 | 10001 | 应用编码,第三方应用唯一标识。由物联卡集团客户向中国移动提出API接入申请,中国移动物联网全网管理员在运营管理平台上分配并反馈给集团客户(反馈方式:邮箱),appid样例:100001 |
content |
否 | 无 | Content短信内容 | 短信内容 |
温馨提示:由于业务的特殊性,appid 、content参数不能包含“#”,以免产生业务识别错误。 短信内容示例:“100001#123456789”。
注意:客户的业务平台接收地址必须以/uplinkMsg结尾,如:http://118.10.233.119:7001/uplinkMsg
参数说明:
参数 | 是否必须 | 默认值 | 含义 |
---|---|---|---|
status |
是 | 无 | 错误码。0-成功 非0-失败 部分号码成功,部分号码失败时,返回0-成功 |
message |
是 | 无 | 错误信息。错误码对应的错误描述,参考错误码列表(成功时,返回消息“ok”) |
info |
是 | 无 | status返回“非0”时,info为空,此时不需要解析info的数据,只有在status为“0”,info才有数据 |
info:
参数 | 是否必须 | 默认值 | 含义 |
---|---|---|---|
sno |
是 | 无 | 流水号。长度为22位,由转发时系统时间yyyyMMddHHmmssSSS+5位随机数组成 |
msisdn |
是 | 无 | 发送短信的物联网终端卡号 |
content |
是 | 无 | 终端发送的短信内容 |
{
"status": "0",
"message": "OK",
"info":{
"sno": "2018053018013599998012",
"msisdn": "1064826090110",
"content": ""
}
}
客户业务平台成功接收消息后,必须返回应答消息。超过5秒未收到客户业务平台的响应消息则认为发送超时,API服务平台重新发送,重发3次还未成功则不再放弃发送。客户业务平台应答的错误码不为“0”时,认为发送错误,API服务平台重新发送。
参数说明:
参数 | 是否必须 | 默认值 | 含义 |
---|---|---|---|
status |
是 | 无 | 错误码。0-成功 非0-失败 部分号码成功,部分号码失败时,返回0-成功 |
message |
是 | 无 | 成功时,返回消息“ok” |
{
"status": "0",
"message": "ok"
}