短信类

CMIOT_API5001-物联卡终端控制下行模板短信

集团客户可通过目标终端发送上行短信给对应的业务平台,其短信格式为:appid#短信内容。 集团客户需在API接入申请的时候同步提交接收上行短信的业务平台ip地址。


API请求参数说明:

参数 是否必须 默认值 格式举例 含义

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

终端发送的短信内容


API响应示例

                {
    "status": "0",
    "message": "OK",
    "info":{
        "sno": "2018053018013599998012",
        "msisdn": "1064826090110",
        "content": ""
    }
}
            

客户业务平台应答参数说明

客户业务平台成功接收消息后,必须返回应答消息。超过5秒未收到客户业务平台的响应消息则认为发送超时,API服务平台重新发送,重发3次还未成功则不再放弃发送。客户业务平台应答的错误码不为“0”时,认为发送错误,API服务平台重新发送。

参数说明:

参数 是否必须 默认值 含义

status

错误码。0-成功 非0-失败 部分号码成功,部分号码失败时,返回0-成功

message

成功时,返回消息“ok”


API响应示例

                    {
    "status": "0",
    "message": "ok"
}

错误码

  • 查看错误码

API工具

  • token生成工具
  • SDK工具下载