banner

数米短信平台HTTP接口

HTTP接口说明文档 

第一章           短信平台介绍

1.1 简介

本系统是本司自主研发的系统,用于实现终端客户短信/彩信发送的管理平台,本文档为第三方平台使用API接口,与本短信平台进行对接而完成。本接口提供了HTTP实现方式。对于采用HTTP协议的用户,出于数据安全性和数据容量的考虑,建议采用http中的Post方法连接Api地址进行数据传输。

sm.png

1.2 缩率语

客户端:本文中特指企业客户侧系统。

服务端:本文中特指本司系统。

长短信:超过70字为长短信,长短信按67/条扣费。用户收到显示一条(手机会合并多条信息)。

字符:平台最大支持500字,标点符号,签名,英文,汉字都算一个字。


第二章           API接口说明

2.1 普通短信发送

         提交地址:http://api.shumi365.com:8090/sms/send.do

         接口提交方式:GET/POST

         功能:普通群发

参数名称

说明

备注

userid

用户名


timespan

时间戳

格式为yyyyMMddHHmmss

pwd

密码

此处用原始密码+时间戳做MD5加密,32位大写格式

mobile

手机号

多个用英文逗号隔开

msgfmt

编码类型

选填,如果不填默认为GBK,可以选填GBK或者UTF8/UTF-8

content

内容

base64加密操作,编码方式使用msgfmt中的方式,如果msgfmt有值的话

ext

扩展

选填, 纯数字

具体支持位数咨询客服

msgid

唯一标识

选填,如果不填系统自动生成作为当前批次的唯一标识

attime

定时时间

选填,2008-06-09 12:00:00


返回值说明:提交成功,返回当前提交数据的唯一标记ID

提交样例:

http://api.shumi365.com:8090/sms/send.do?userid=******&pwd=66FDD754657E6D7E98E3BDDF14B2A179&timespan=123456&mobile=188****8888&content=xPq1xNHp1qTC686qMTIz

2.2 个性短信发送

提交地址:http://api.shumi365.com:8090/sms/sendData.do

接口提交方式:GET/POST

         功能:针对不同号码不同内容群发

 

参数名称

说明

备注

userid

用户名


timespan

时间戳

格式为yyyyMMddHHmmss

pwd

密码

此处用原始密码+时间戳做MD5加密,32位大写格式

mobile

手机号

多个用英文逗号隔开

msgfmt

编码类型

选填,如果不填默认为GBK,可以选填GBK或者UTF8/UTF-8

content

内容

base64加密操作,编码方式使用msgfmt中的方式,如果msgfmt有值的话,内容之间用逗号隔开,内容个数需要与手机号个数相等。

ext

扩展

选填, 纯数字

具体支持位数咨询客服

attime

定时时间

选填,2008-06-09 12:00:00

返回值说明:提交成功,返回当前提交数据的唯一标记ID

 

2.3 查询余额

提交地址:http://api.shumi365.com:8090/sms/balance.do

接口提交方式:GET/POST

         功能:查询余额

参数名称

说明

备注

userid

用户名


timespan

时间戳

格式为yyyyMMddHHmmss

pwd

密码

此处用原始密码+时间戳做MD5加密,32位大写格式

返回值说明:成功返回当前账户余额。

附录

 

错误码

描述

-101

用户不存在

-102

密码不正确

-103

余额不足

-104

参数格式有误

-105

扩展码权限错误

-106

内容超长(500)

-107

用户状态异常

-108

Ip鉴权失败

-109

内容解析异常

-990

未知异常

附数米短信平台接口文档下载,数米官网:http://www.shumi365.com/

数米HTTP接口说明文档(短信).docx


阅读: 4178
本文由中文短信网原创,转载请保留链接!
中文短信网
https://www.zhsms.com/interface/25.html

留言评论

暂无留言