1 短信发送

接口功能： 向指定手机发送短信

请求方向： 第三方应用平台 → 短信接口（服务端）

请求方法： POST

请求 URI： http://{BaseUrl}/sms/sendsms

请求消息体：

参数名 类型 最大长度 是否可选 解 释
appkey String 32 必选 应用的appkey
sign String 必选 加密字符串
time datetime 必选 请求时间
phone String 32 必选 发送号码,可用英文逗号字符”,”隔开发送多个,如:13232323232,15050505050
msgcontent String 32 必选 发送内容

响应消息：

{
    "success": true,
    "code": 200,
    "msg": "",
    "data": [
        {
            "mid": "39C81C0382726876",
            "mobile": "13232323232",
            "result": "0"
        }
    ]
}

result错误代码表:

错误代码 具体含义
10 原发号码错误，即extno错误
15 余额不足
17 账号签名无效
0 提交成功

2. 短信数据查询

接口功能： 查询短信的记录

请求方向： 第三方应用平台 → 短信接口（服务端）

请求方法： POST

请求 URI： http://{BaseUrl}/sms/query

请求消息体：

名称 类型 描述 示例值
starttime String 开始时间 2021-08-16 00:00:00
endtime String 结束时间 2021-08-16 23:00:00
sendstatus Int 状态 0: 无返回状态 1: 发送成功 2: 发送失败 3: 状态未知
page Int 页码 1

响应消息:

# 成功
{
    "success": true,
    "msg": "",
    "code": 200,
    "data": {
        "count": 2,
        "list": [
            {
                "msgid": "210816114919873xxxx",
                "smscontent": "此处是内容1",
                "tophone": "177xxxxxxxx",
                "sendtime": "2021-08-16 11:49:19",
                "sendstatus": "1",
                "splitnum": "1"
            },
            {
                "msgid": "210816114015882xxxx",
                "smscontent": "此处是内容2",
                "tophone": "137xxxxxxxx",
                "sendtime": "2021-08-16 11:40:16",
                "sendstatus": "1",
                "splitnum": "1"
            }
        ],
        "page": 1
    }
}

msgid 为消息唯一id
smscontent 为消息内容
tophone 接收方手机号
sendtime 发送时间
sendstatus 发送状态
splitnum 短信条数，70个字为一条

3. 数据推送

格式:

{
    "flag":1,
    "mid":"2108161137148823723",
    "mobile":"13800000001 ",
    "stat":"DELIVRD",
    "time":"2021-08-16 11:37:15"
}

说明:

名称 类型 描述 示例值
mid String 消息ID 2108161137148823723
mobile String 手机号码 13800000001
stat String 状态报告编码 DELIVRD
time String 发送时间 2021-08-16 11:37:15

重推说明：
需要接收端返回一串json

{"code":200}

如未返回， 则会进行重推
重推的最大次数为5次， 时间间隔分别为60,300,600,3600,3600秒


文档更新时间: 2022-03-21 03:15   作者：admin