短信业务开发接口协议.doc

短信业务开发接口协议

接口均采用HTTP协议，GET方法。URL参数和返回值字母均为小写，标点为英文半角。
一。发送接口

合作方 à 短信平台。

参数名称
参数说明
name
客户用户名
pwd
客户密码
dest
接收手机号码，如果为多个，用半角逗号分割，最多50个。
content
下发内容
name、pwd或content包含非英文和数字字符，务必要URLEncode。

返回：
１。如果参数正确，返回如下：
success：$1
参数1是 本次发送 不超过20位的10进制 消息编号（MSGID），形如 0603015522454756885
如果发送超长短信，系统将自动按每条70字符分拆。假设系统拆分为两条短信，则返回格式：success：$1：$2
参数2是被拆分的第二条短信的MSGID

2。如果参数有误，返回如下：
error：$1
参数1是对错误的描述
二。上行接收接口

短信平台 à 合作方，由合作方提供上行HTTP接收地址。

参数名称
参数说明
name
见“发送接口”定义
src
源号码（用户手机号码）
dest
目的号码
content
上行内容
time
上行接收时间，格式如：2008-11-11 10:00:00

返回：
如果正确，则返回：success
否则返回：error：错误说明
三．状态报告接收接口

短信平台 à 合作方，由合作方提供状态报告HTTP接收地址。

参数名称
参数说明
name
见“发送接口”定义
report
状态报告，每次最多20条。

状态报告格式：
一条状态报告格式：消息编号、手机号码、状态报告，提交时间，用半角逗号分割。
多条：每条状态报告间用半角分号分割。每次最多20条。
例如：
1203110100547341956,13882768136,DELIVRD,2009-12-03 11:05:38; 1203110100547341956,13124569889,
DELIVRD,2009-12-03 11:05:38

返回：
如果正确，则返回：success
否则返回：error：错误说明

四：获取账户余额接口

合作方 à 短信平台。

参数名称
参数说明
name
见“发送接口”定义

返回：
１。如果参数正确，返回如下：
success：$1
参数1是 账户余额

2。如果参数有误，返回如下：
error：$1
参数1是对错误的描述

五：接口地址及错误编号对照
★接口地址：
下行接口：
余额查询：
JAVA版demo：
屏蔽字：