无限通接口手册2.1(4)

无限通平台接口手册

参数名称 response phone smsID stat 描述 大于0：此消息ID所对应的状态报告条数。最多100条； 0：没有此消息ID的状态报告； -1：帐号登陆失败； -3：此帐号被禁用； -4：ip鉴权失败； -8：缺少请求参数。 -9：访问速度太快，每次访问间隔不能小于30秒 手机号。 消息ID。 状态报告 0：成功； 2：发送失败。 请求错误返回页面示例：

-8

请求成功返回页面示例：

1 -

13601655231

2c92812d1ebf8704011ebf939ba80004

0

2.3.4. 查询余额

功能：查询剩余短信跟彩信的条数。 地址： http://3tong.net/http/GetBalance

建议采用post方法提交请求。调用查询余额间隔时间不小于30秒。

请求参数定义如下：

第 16 页 共 45 页

无限通平台接口手册

参数名称 Account Password

返回参数定义如下： 参数名称 response 描述 帐号 密码 字段值 String，不空。 String，不空（需MD5加密）。 描述 -1：帐号登陆失败； -3：此帐号被禁用； -4：ip鉴权失败； -8：缺少请求参数。 短信余额。 彩信余额。 sms mms 返回页面示例：

10002000

2.4. WebService接口（xml方式传输）(推荐)

注意：终端客户的接入方式设置为WebService接入时才能使用此接口。 该接口数据输入输出均采用xml格式封装的字符串，编码统一为UTF-8。 访问地址：http://3tong.net/services/sms

事例代码见附件（3.3 webservice接口事例(xml传输)） 2.4.1. 短信下行 名称 功能 接口方法 第 17 页 共 45 页

submit 发送一条或则多条内容相同的短信 String submit (String message) 无限通平台接口手册

输入说明 message参数xml格式如下： admin bb43a2c4081bec02fca7b72f38e63021 2c92825934837c4d0134837dcba00150 13111111111,13222222222,13333333333 短信内容 短信签名 5555 201101011230 字段说明： account ：用户账号 password：账号密码，需采用MD5加密(小写)，如：456.com加密后为bb43a2c4081bec02fca7b72f38e63021 msgid：该批短信编号(32位UUID)，需保证唯一，可空，建议为空 phones：接收手机号码，多个手机号码用英文逗号分隔，最多500，不能为空 content：短信内容，最多500个汉字，不能为空 sign：短信签名，该签名有服务端告知客户端，不可修改，为空时使用默认值 subcode：扩展子号码，内容可空（验证格式和长度，不能超过20位） sendtime：发送时间,格式yyyyMMddHHmm,可空(12位数字，年月日时分，比如201111180929) 输出说明 返回的结果xml格式如下： 2c92825934837c4d0134837dcba00150 0 系统编码:GBK 提交成功 黑名单号码 字段说明： msgid：该批短信编号 result：该批短信提交结果 0——提交成功 第 18 页 共 45 页

无限通平台接口手册

1——账号无效 2——密码错误 3——msgid不唯一 4——存在无效手机号码 5——手机号码个数超过最大限制 6——短信内容超过最大限制 7——扩展子号码无效 8——发送时间格式无效 9——请求来源地址无效 10——内容包含敏感词 11——余额不足 97——接入方式错误 98——系统繁忙 99——消息格式错误

2.4.2. 短信上行 名称 功获取上行短信。每次调用间隔需大于30秒 能 接String deliver(String message) 口方法 输message 参数xml格式如下：

deliver 无限通平台接口手册

入encoding=\?>adminbb43a2c4081bec02fca7b72f38e63021 明 字段说明： account ：用户账号 password：账号密码，需采用MD5加密(小写)，如：456.com加密后为bb43a2c4081bec02fca7b72f38e63021 输返回的结果xml格式如下： 出0成明 功13333333333短信内容55552011-11-11 11:11:11 字段说明： result：接口调用结果 0——成功 1——账号无效 2——密码错误 3——请求太快 9——请求来源地址无效 97——接入方式错误 98——系统繁忙 99——消息格式错误 如果result为0时sms标签对将出现0到多次，否则sms标签不出现。 phone：上行手机号码 content：上行短信内容 delivertime：上行接收时间，格式yyyy-MM-dd HH:mm:ss 第 20 页 共 45 页