无限通平台接口手册
String[1]:发送情况返回 (当errMsg 不为负值时该值有效) 格式(无换行符):
2.5.4. 获取上行
调用短信上行间隔时间不小于30秒。 名称 功能 接口方法 输入说明 getSms 获取上行短信,一次最多取10条。 getSms(String account, String password) account用户账号; password用户密码(用MD5加密,32位,加密后字母全部为小写,例如:“123.com“ 加密后应该等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确)。 输出说明 String[] 字符串数组 String[0]:输出参数,小于零时表示下发错误,详情见错误码 第 26 页 共 45 页
无限通平台接口手册
String[1]:返回上行短信(当errMsg 不为负值时该值有效) 格式(无换行符):
调用短信状态报告间隔时间不小于30秒。
名称 功能 接口方法 getReport 获取一条或者多条状态报告。 getReport(String account, String password,MtNewMessage[] message) 输入说明 account用户账号; password用户密码(用MD5加密,32位,加密后字母全部为小写,例如:“123.com“ 加密后应该等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确); MtNewMessage,详情请参照自定义数据结构:MtNewMessage,包含消息序号和手机号码的对象数组。(只需要填写smsId和phoneNumber字段)。 第 27 页 共 45 页
无限通平台接口手册
输出说明 String[] 字符串数组 String[0]: 输出参数,小于零时表示下发错误,详情见错误码 String[1]: 返回状态报告(当errMsg 不为负值时该值有效) 格式(无换行符):
调用获取余额报告间隔时间不小于30秒。
名称 功能 获取帐号余额。 getBalance 接口方getBalance(String account, String password) 法 输入说account用户账号; 明 password用户密码(用MD5加密,32位,加密后字母全部为小写,例如:“123.com“ 加密后应该等于 第 28 页 共 45 页
无限通平台接口手册
“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确)。 输出说String[] 字符串数组 明 String[0]:输出参数,小于零时表示下发错误,详情见错误码 String[1]:返回账户余额(当errMsg 不为负值时该值有效) 格式(无换行符):
-1:输入参数不正确,请检查账户,密码,等输入参数是否为空
-2:账户不存在,请检查用户名密码是否正确
-3:账户已经超过每日发送短信限制数量(当账户被限制每日发送量时有用) -4:客户端ip地址不正确(当需要ip校验时) -5:smsId与数据库重复(下发短信时,如果smsId 由客户端传入,该参数不能重复) -6:内容含有非法关键字,请检查下发内容。
-7:对应的号码下发失败,下发号码为空或其他错误,导致该号码发送失败 -8:账户余额不足 -11:账户接入方式不对
2.6. WebService接口(兼容企信通)(建议不用)
注意:终端客户的接入方式设置为WebService接入时才能使用此接口
地址:http://3tong.net/services/SmsOperator
2.6.1. 自定义数据结构
MTMessage 参数名称 sequenceId 类型 String 说明 消息序号,用来取状态报告时候匹配,可以为空,建议不填写,为空时返回的MTResponse会自动生成一个唯一的消息序号。 第 29 页 共 45 页
无限通平台接口手册
phoneNumber String 手机号码。支持多号码,号码之间用英文逗号隔开,建议最多100个。如: 13800000000,13900000000。 content String 短信内容。 下行时间,可以为空。 scheduleTime Date
MTResponse 参数名称 isSuccess 类型 boolean 说明 是否调用成功 true:成功; false:失败。 当该值为false时,其他的字段值无效。 sequenceId phoneNumber String String 消息ID,用来取状态报告时候匹配。 手机号码。
MOMessage 参数名称 sequenceId phoneNumber content 类型 String String String 说明 消息序号。 手机号码。 短信内容。 下行时间,可以为空。 是否调用成功 true:成功; false:失败。 receivedTime Date isSuccess boolean
MTReport 参数名称 isSuccess 类型 boolean 说明 是否调用成功 true:成功; false:失败。 当该值为false时,其他的字段值无效。 第 30 页 共 45 页