注册有礼

随月云短信·让通信更简单

短信网关接口 SMS57Json

日期：2024-03-20　浏览：80


1.短信发送接口


1.1、请求URL，请求方式 HTTP POST Json

http://gw.suisms.net:7862/sms?action=send


1.2、参数说明


参数需要 URLENCODE，编码方式采用UTF-8


参数名称含义说明
action发送任务命令设置为固定的:send
account发送用户帐号用户帐号
password发送帐号密码用户账号对应的密码
mobile手机号码发信发送的目的号码.多个号码之间用半角逗号隔开
content发送内容短信的内容，内容需要UTF-8编码
extno接入号接入号，即 10690XXXXXX类似的号码
rt响应数据类型json


1.3、示列


http://gw.suisms.net:7862/sms?action=send&account=账号&password=密码&mobile=15000000000,15000000001&content=内容&extno=10690&rt=json


1.4、返回参数,返回以xml的方式返回处理结果


{
     "status": "0",
     "balance": -153278040,
     "list": [
            {
             "mid": "4C2CA88382720003",
             "mobile": "1399****633",
              "result": 0
            },
            {
              "mid": "4C2CA88382720004",
              "mobile": "1399****633",
              "result": 0
          }
       ]
}


字段含义
status请求结果，具体参见STATUS错误代码表
balance当前账户余额，单位厘
list短信提交响应列表
mid消息ID（用于状态报告匹配）
mobile手机号码
result短信提交错误代码，参见RESULT错误代码表


2.点对点发送


2.1、请求URL，请求方式 HTTP POST Json

http://gw.suisms.net:7862/sms?action=p2p


请求方式可以 POST 和 GET方式，建议采用POST方式


2.2、参数说明


参数需要 URLENCODE，编码方式采用UTF-8


参数名称含义说明
action发送任务命令设置为固定的:p2p
account发送用户帐号用户帐号
password发送帐号密码用户账号对应的密码
mobileContentList号码短信内容列表

号码内容格式为：Mobile[TAB]Content  多个号码之间用换行分割如：

1380***0001 下发内容1

1380***0002 下发内容2

1380***0003 下发内容3

content发送内容短信的内容，内容需要UTF-8编码
extno接入号接入号，即SP服务号（106XXXXXX）


2.3、示列


http://gw.suisms.net:7862/sms?action=p2p&rt=json&account=922011&password=123456&mobileContentList=13800000001%23%e4%b8%8b%e5%8f%91%e5%86%85%e5%ae%b91%0d13800000002%23%e4%b8%8b%e5%8f%91%e5%86%85%e5%ae%b92%0d13800000003%23%e4%b8%8b%e5%8f%91%e5%86%85%e5%ae%b93%0d13800000004%23%e4%b8%8b%e5%8f%91%e5%86%85%e5%ae%b94%0d&extno=10690231221


2.4、返回参数,返回以xml的方式返回处理结果


   {
        "status": "0",
        "balance": -153278280,
        "list": [
             {
               "mid": "4C372C4382720007",
                "mobile": "1380***0001",
               "result": 0
             },
             {
               "mid": "4C372C4382720008",
               "mobile": "1380***0002",
               "result": 0
            },
            {
               "mid": "4C372C4382720009",
               "mobile": "1380***0003",
               "result": 0
             },
             {
               "mid": "4C372C438272000A",
               "mobile": "1380***0004",
               "result": 0
             }
             ]
   }


参数名称含义
status请求结果，具体参见STATUS错误代码表
balance当前账户余额，单位厘
list短信提交响应列表
mid消息ID（用于状态报告匹配）
mobile手机号码
result短信提交错误代码，参见RESULT错误代码表


3.余额查询接口


3.1、请求URL，请求方式 http post


http://gw.suisms.net:7862/sms?action=overage


3.2、参数说明


参数名称含义说明
action发送任务命令设置为固定的:report
account发送用户帐号用户帐号
password发送帐号密码用户账号对应的密码
rt响应数据类型json


3.3、示列


http://gw.suisms.net:7862/sms?action=balance&account=账号&password=密码&rt=json




3.4、返回值


{"status":0,"balance":-153278040,"chargeType":"POSTCHARGE"}


参数名称含义
status请求结果，具体参见STATUS错误代码表
balance当前账户余额，单位厘
chargeTypePOSTCHARGE=后付费 PRECHARGE=预付费



4.客户端主动获取状态报告接口


4.1、请求URL，请求方式 HTTP POST 或 GET方式


http://gw.suisms.net:7862/sms?action=report


4.2、参数说明


参数名称含义说明
action发送任务命令设置为固定的:report
account发送用户帐号用户帐号
password发送帐号密码用户账号对应的密码
rt响应数据类型json


4.3、示列


http://gw.suisms.net:7862/sms?action=report&action=report&account=账号&password=密码&rt=json



4.4、返回参数,返回以xml的方式返回处理结果


<?xml version="1.0" encoding="utf-8" ?>
          {
            "status": "0",
            "balance": -153278040,
            "list": [
            {
                "flag": 1,
                "mid": "4C36654382720005",
                "spid": "922011",
                "accessCode": "106901234",
                "mobile": "13991971633",
                "stat": "MA:0029",
                "time": "2017-04-12 01:38:21"
            },
            {
                "flag": 1,
                "mid": "4C36654382720006",
                "spid": "922011",
                "accessCode": "106901234",
                "mobile": "13991971633",
                "stat": "MA:0029",
                "time": "2017-04-12 01:38:21"
            }
            ]
          }


字段含义
action请求结果，具体参见STATUS错误代码表
balance当前账户余额，单位厘
list详细状态报告列表
flag1=状态报告
mid消息ID(与提交时响应的消息ID匹配)
spid归属账号（可忽略）
mobile手机号码
accessCode下发号码
stat短信提交错误代码，参见RESULT错误代码表
time状态报告的具体时间



5.客户端主动获取手机上行接口


用户客户端向网关获取手机上行回复的短信


5.1、请求URL，请求方式 http post


http://gw.suisms.net:7862/sms?action=mo


5.2、参数说明


参数需要 URLENCODE，编码方式采用UTF-8


参数名称含义说明
action发送任务命令设置为固定的:send
account发送用户帐号用户帐号
password发送帐号密码用户账号对应的密码
rt响应数据类型json


5.3、示列


http://gw.suisms.net:7862/sms?action=mo&action=mo&account=账号&password=密码


5.4、响应数据


      {
                "status": "0",
                "balance": -153278040,
                "list": [
                     {
                        "flag": 0,
                        "mid": "4C36654382720005",
                        "spid": "922011",
                        "mobile": "13991971633",
                        "content": "上行内容",
                        "time": "2017-04-12 01:38:21"
                    },
                    {
                        "flag": 1,
                        "mid": "4C36654382720006",
                        "spid": "922011",
                        "mobile": "13991971633",
                        "stat": "测试内容",
                        "time": "2017-04-12 01:38:21"
                    }
                ]
      }


字段含义
status请求结果，具体参见STATUS错误代码表
balance当前账户余额，单位厘
list详细状态报告列表
flag0=手机用户上行
mid消息ID(与提交时响应的消息ID匹配)
spid归属账号（可忽略）
mobile手机号码
accessCode接收号码，即SP服务号（106XXXXXX）
stat短信提交错误代码，参见RESULT错误代码表
content手机上行的具体内容
time手机上行的具体时间



6.客户端被动接收上行和状态报告


用于网关向客户端推送状态报告


6.1、请求方式


由客户端向网关报备推送地址，请求方式 由网关采用POST方式，推送到客户端


6.2、请求参数


    [
        {
            "flag": 0,
            "mid": "4C36654382720005",
            "spid": "922011",
            "mobile": "13991971633",
            "content": "上行内容",
            "time": "2017-04-12 01:38:21"
        },
        {
            "flag": 1,
            "mid": "4C36654382720006",
            "spid": "922011",
            "mobile": "13991971633",
            "stat": "DELIVRD",
            "time": "2017-04-12 01:38:21"
        }
      ]


字段含义
list详细状态报告列表
flag0=手机用户上行
list详细状态报告列表
flag0=手机用户上行
midflag=1时，消息ID与提交时响应的消息ID匹配；flag=0时，表示该条上行的消息ID
spid归属账号（可忽略）
mobile手机号码
accessCode接收号码，即SP服务号（106XXXXXX）
stat短信提交错误代码，参见RESULT错误代码表
content手机上行的具体内容
stat状态报告代码，具体参见STAT状态代码表；flag=0时，该字段无效
time手机上行的具体时间


7. STATUS错误代码表

 

错误码错误描述
0成功
1消息包格式错误
2IP鉴权错误
3账号密码不正确
4版本号错误
5其它错误
6接入点错误（如账户本身开的是CMPP接入）
7账号状态异常（账号已停用）
21连接过多
100系统内部错误，一般情况下例如：提交手机号码为 电信，但是该账号没用可用的电信接出点
102单次提交的号码数过多（建议200以内）

8. RESULT错误代码表

 

错误码错误描述
10原发号码错误，即extno错误
15余额不足
17账号签名无效

9. STAT状态代码表

 

错误代码说明
DELIVRD短信投递成功
EXPIREDMessage validity period has expired
DELETEDMessage has been deleted.
REJECTEDMessage is in a rejected state
MA:0001全局黑名单号码
MA:0002内容非法
MA:0003无法找到下级路由
MA:0004未知
MA:0005目的号码格式错误
MA:0006系统拒绝
MA:0009未定义错误
MA:0009未定义错误
MA:0011未知系统内部错误
MA:0009未定义错误
MA:0012防钓鱼
MA:0013非法错误的包时序
MA:0014非法的OP_ISDN号段
MA:0021号码格式错误
MA:0022号码超过半小时下发次数限制
MA:0023客户黑名单号码
MA:0024内容未报备
MA:0025不支持该短信
MA:0026分条发送，组包超时
MA:0025不支持该短信
MA:0027通道黑名单
MA:0028全局黑名单号段
MA:0029通道黑名单号段
MA:0029通道黑名单号段
MA:0030直接产生拒绝报告
MO:200不支持分条短信
MO:0254转发提交超时
MO:0255转发提交过程中，连接断开
MO:NNNNNNNN为对外提交过程中，上级网关的返回值，具体含义需上级网关解释

10. 常见错误

 错误码10

提交短信过程中返回10，接入码错误，即extno=106XXXXXX 不正确，

解决方法：填写正确的接入码（网关管理员 可以从生产账号摘要中获取该接入号）  


错误码17

解决方法：  

  • 提交内容中带上网关管理员已经报备的签名

  • 网关管理员 在（客户管理->账号签名报备）中关闭该账号的签名校验功能


错误码15

提交短信过程中返回15 余额不足  

解决方法：  

  • 网关管理员 对该账号充值

  • 网关管理员 将该账号设置为后付费


相关文章阅读

    •
关键词：
上一篇：没有了！
下一篇：彩信接口 HTTP

最新新闻

解决方案

仅需3步，轻松投放短信广告

  • 注册短信帐号

    注册短信帐号

  • 注册短信帐号

  • 身份认证

    身份认证

  • 身份认证

  • 短信充值

    短信充值

  • 短信充值

  • 推送信息

    推送信息

    • 现在注册，即享 新用户礼包!

    注 册 有 礼

    • 工信部核准SP资质

    • 5秒钟闪电体验

    • 10分钟快速接入

    • 7x24小时售后支持

    咨询热线
    010-57252000

    （工作日9:00-21:00）

    其余时间请联系您
    专属客服的手机或微信

    扫一扫微信咨询

    Copyright © 2015 - 2024 随月科技 All Rights Reserved.   京ICP备16066491号-2   京公网安备11022902000265   XML地图