立即注册

免费试用

免费试用
导航
您现在位置:开发者中心 - 短信平台

短信平台

接口说明:接口编码方式采用统一的UTF-8,请求方式采用HTTP REST,支持GET/POST方式

1 短信发送接口

用户客户端向网关提交短信

1.1. 请求地址

http://host:port/sms

https://host/sms使用https需要联系供应商是否支持
         请求方式可以 POST 和 GET方式,建议采用POST方式

1.2. 参数说明

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

参数名称含义说明
action请求动作设置为固定的:send
account发送用户帐号用户帐号,由系统管理员
password发送帐号密码非加密:password                加密:MD5(password+extno+content+mobile)
mobile全部被叫号码发信发送的目的号码.多个号码之间用半角逗号隔开,最多500个号码
content发送内容短信的内容,内容需要UTF-8 URLEncode编码
extno接入号接入号,即SP服务号(106XXXXXX)
rt响应数据类型json

http://host:port/sms?action=send&account=账号&password=密码&mobile=15023239810,13527576163&content=内容&extno=1069012345&rt=json

1.3. 响应数据

{

"status": "0",

"balance": -153278040,

"list": [

    {

        "mid": "4C2CA88382720003",

        "mobile": "18983437010",

        "result": 0

    },

    {

        "mid": "4C2CA88382720004",

        "mobile": "18983437011",

        "result": 0

    }

]

}

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

2.点对点发送

用于客户端向网关提交点对点短信,即一个号码一个内容的短信

2.1. 接口请求地址

http://host:port/sms

https://host/sms使用https需要联系供应商是否支持
         请求方式可以 POST 和 GET方式,建议采用POST方式

2.2. 参数定义

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

参数名称含义说明
action请求动作设置为固定的:p2p
account发送用户帐号用户帐号,由系统管理员
password发送帐号密码非加密:password
               加密:MD5(password+extno+mobileContentList)
               (加密时mobileContentList换行符去掉)
mobileContentList号码短信内容列表号码内容格式为:Mobile#Content
                 多个号码之间用换行分割如:
                 13800000001#下发内容1
               13800000002#下发内容2
               13800000003#下发内容3
               13800000004#下发内容4
extno接入号接入号,即SP服务号(106XXXXXX)
rt响应数据类型json

http://192.168.1.4:7822/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.3. 响应数据

{

    "status": "0",

    "balance": -153278280,

    "list": [

        {

            "mid": "4C372C4382720007",

            "mobile": "13800000001",

            "result": 0

        },

        {

            "mid": "4C372C4382720008",

            "mobile": "13800000002",

            "result": 0

        },

        {

            "mid": "4C372C4382720009",

            "mobile": "13800000003",

            "result": 0

        },

        {

            "mid": "4C372C438272000A",

            "mobile": "13800000004",

            "result": 0

        }

    ]

}

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

3.余额查询接口

用于客户端查询当前账户余额

3.1.请求地址

http://host:port/sms

https://host/sms使用https需要联系供应商是否支持
         请求方式可以 POST 和 GET方式,建议采用POST方式

3.2.参数说明

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

参数名称含义说明
action请求动作设置为固定的:balance
account用户帐号用户帐号,由系统管理员
password帐号密码非加密:password        加密:MD5(password)
rt响应数据类型json

http://host:port/sms?action=balance&account=账号&password=密码&rt=json

3.3.响应数据

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

字段说明
status请求结果,具体参见STATUS错误代码表
balance当前账户余额,单位厘
chargeTypePOSTCHARGE=后付费 PRECHARGE=预付费 

专业、便捷、稳定的企业通信能力开放平台,点击注册立即免费试用!

免费注册
©2020 北京祥云智通科技有限公司. All rights reserved. 京ICP备17071816号-1