群发短信

最近更新时间:2019-06-26 14:55:49

说明:

请求采用 HTTPS 传输,使用 POST 方法。请求包体采用 x-www-form-urlencoded,应答包体采用 JSON 格式,SDKAppID 由腾讯物联卡平台分配,random 为随机整数,不要添加零前缀。如您需在内测阶段调用接口进行测试,请向腾讯云物联卡技术支持(物联卡小助手 QQ:3513545165)申请 SDKAppID 和 appkey。

接口描述

用于向物联卡下发短信接口为 sendmultisms,当前版本为 v1。

接口域名

https://cloud.tim.qq.com/v1/iotlink/sendmultisms?sdkappid=14000xxxxx&random=xxxx

输入参数

参数名称 描述 类型 必选
Iccids 物联卡 ID 字符串
Msg 给物联卡下发短信的内容,UTF-8 编码 字符串
Token 鉴权 TOKEN 字符串
Time 请求时间,UNIX 时间戳 整数
Echo 服务端按原样带回 字符串

注意:

  • Token 计算方式 :
    Token = sha256("Action=sendmultisms&Appkey=xxxxxxx&Iccids=xxxxxxxx&Random=xxxxxxxxxxx&Time=xxxxxxxxxx");
    其中 Action 值为 Url 对应的 CGI 名字,即 sendsms
  • 计算示例:
    Token = sha256("Action=sendmultisms&Appkey=b7ff449a4bf9417fdf23d7faa0e10813&Iccids=898602b8011730558259,89860617010001400111&Random=1234&Time=1511339664");
    = a27e29b05d4dfda0d9f8d99645d30c4c8b66f68ee68f488765c94fdc6b66fa99

输出参数

参数名称 描述 类型 必选
ActionStatus 请求处理结果,OK 表示成功,FAIL 表示失败。如果 FAIL,ErrorInfo 带上失败原因 字符串
ErrorCode 请求返回码,0为成功,非0为失败 整数
ErrorInfo 失败原因 字符串
Detail 每张物联卡的请求结果详情 对象
Iccid 物联卡 ID 字符串
Sid 标识本次发送 字符串
Echo 服务端按原样带回 字符串

示例

输入:

Iccids=898602b8011730558259,89860617010001400111&Msg=发送的短信内容&Token=a27e29b05d4dfda0d9f8d99645d30c4c8b66f68ee68f488765c94fdc6b66fa99&Time=1511339664

输出:

    {
        "ActionStatus": "OK",
        "ErrorCode": 0,
        "ErrorInfo": "OK",
        "Echo": "",
        "Detail": [
            {
                "ActionStatus": "OK",
                "ErrorCode": 0,
                "ErrorInfo": "",
                "Iccid": "898602b8011730558259",
                "Sid": "xxxxxxx"
            },
            {
                "ActionStatus": "OK",
                "ErrorCode": 0,
                "ErrorInfo": "",
                "Iccid": "89860617010001400111",
                "Sid": "xxxxxxx"
            }
        ]
    }