无限通平台接口手册
msgid:短信编号 phone:下行手机号码 content:上行短信内容 status:短信发送结果 0——成功 1——失败 2——不确定 2.2.4. 查询余额
访问地址:http://3tong.net/http/sms/Balance
名称 功获取余额,每次调用间隔需大于60秒。 能 输message参数xml格式如下: 入
balance 无限通平台接口手册
字段说明: result:接口调用结果 0——成功 1——账号无效 2——密码错误 3——请求太快 9——请求来源地址无效 97——接入方式错误 98——系统繁忙 99——消息格式错误 当result为0时sms标签对出现1次,否则sms标签对不出现。 amount:剩余金额,保留3位小数,单位元 number:剩余短信数 freeze:冻结金额,保留3位小数,单位元 当result为0时mms标签对出现1次,否则mms标签对不出现。 amount:剩余金额,保留3位小数,单位元 number:剩余彩信数 freeze:冻结金额,保留3位小数,单位元
2.3. http接口(兼容企信通)
注意:终端客户的接入方式设置为http接入时才能使用此接口 2.3.1. 短信下行
功能:下发单条或者多条内容相同的短信。 地址:http://3tong.net/http/SendSms 建议采用post方法提交请求。
事例代码见附件(3.2 http接口示例) 第 12 页 共 45 页
无限通平台接口手册
请求参数定义如下: 参数名称 描述 Account 帐号 Password 密码 SubCode 子号码 Phone 手机号码 Content 短信内容 Wappushurl SendTime Wappushurl 定时发送时间 字段值 String,不空。 String,不空(需MD5加密,32位,加密后字母全部为小写,例如:“123.com“ 加密后应该等于“cbff36039c3d0212b3e34c23dcde1456”用户可以用此例子验证加密方法是否正确 )。 String,可以为空。例如:如果平台号码为“10650300”,子号码为“22”,则短信将以“1065030022”号码下发给手机用户(注:此功能需要通道支持)。 String,不空,支持多号码,号码之间用英文逗号隔开,最多100个。如: 13800000000,13900000000。 String,不空 。UTF-8编码 Java例: java.net.URLEncoder.encode(Content, \。 Wappush 地址,如果需要发送Wappush,则 Content表示 title String,可以为空,为空就是立即发送。定时发送格式为年月日时分,如:200803201615。 返回参数定义如下: 参数名称 response 描述 >0:成功条数; -1:帐号不存在,请检查用户名或者密码是否正确; -2:账户余额不足; -3:帐号已被禁用; -4:ip鉴权失败(需要ip校验的场合); -8:缺少请求参数或参数不正确(请检查用户名,密码,下发号码,下发内容是否为空,或者下发号码数量是否大于100个); -9:内容不合法(含有非法内容,请检查下发内容)。 -10:账户当日发送短信量已经超过允许的每日最大发送量(账户被限制每日发送短信数量的情况有用) -11:账号接入方式不对 -99:客户购买产品未生效 手机号。 短信ID(用于匹配状态报告)。 phone smsID 第 13 页 共 45 页
无限通平台接口手册
失败返回页面示例:
成功返回页面示例:
2.3.2. 短信上行
功能:接收若干条手机用户的上行短信(一次最多十条)。 地址: http://3tong.net/http/GetSms
建议采用post方法提交请求。调用短信上行间隔时间不小于30秒。 请求参数定义如下: 参数名称 描述 字段值 Account 帐号 String,不空。 Password 密码 String,不空(需MD5加密)。 返回参数定义如下: 参数名称 描述 大于0:上行短信的条数,一次最多取10条; response 0:没有上行短信; -1:帐号登陆失败; -3:此帐号被禁用; -4:ip鉴权失败; -8:缺少请求参数。 -9:访问速度太快,每次访问间隔不能小于30秒 手机号。 phone 短信内容; content 已经用java.net.URLEncoder.encode()编码; 需要用java.net.URLDecoder.decode()解码。 第 14 页 共 45 页
无限通平台接口手册
上行时间。 sendTime 无短信或者参数错误返回页面示例:
成功返回短信页面示例:(一次最多取10条)
2.3.3. 短信状态报告
功能:根据SmsID返回短信是否成功发送到用户手机。 地址: http://3tong.net/http/GetReport
建议采用post方法提交请求。调用短信状态报告间隔时间不小于30秒。
请求参数定义如下: 参数名称 描述 字段值 Account 帐号 String,不空。 Password 密码 String,不空(需MD5加密)。 SmsID 消息ID String,不空。
返回参数定义如下:
第 15 页 共 45 页