发送短信

最近更新时间:2019-01-31 12:19:29

说明:

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

接口描述

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

接口域名

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

输入参数

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

注意:

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

输出参数

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

示例

输入:

Iccid=898602b8011730558259&Msg=发送的短信内容&Token=4445829b4301d3f2a120c038605f376a3fb48b2e7902275b85044447008f6bd2&Time=1506074049

输出:

    {
        "ActionStatus": "OK",
        "ErrorCode": 0,
        "ErrorInfo": "",
        "Sid": "xxxxxxx",
        "Echo": ""
    }

如果有其他疑问,您也可以在问答社区中寻求帮助。前往问答社区 >