三通运营平台ctc-oss接口手册1(编辑修改稿)

三通运营平台ctc-oss接口手册1(编辑修改稿)内容摘要：

发送一条或则多条内容相同的短信。 接口方法 batchSendSms(String account, String password, MtNewMessage[] message) 输入说明 account 用户账号； password 用户密码（用 MD5 加密 ， 32 位，加密后字母全部为小 写 ， 例 如 ：“ “ 加 密 后 应 该 等 于“ cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确 ）； message对象数组，详情请参照 自定义数据结构： MtNewMessage。 输出说明 String[] 字符串数组 String[0]： 输出参数，小于零时表示下发错误，详情见错误码 三通运营平台 CTCOSS 接口手册 上海大汉三通网络通信有限公司 上海张江高科技园区浦东软件园 20 号楼 5 层 第 13 页 共 30 页 版权所有 (C) 20202033 网址： 全国热线： 4008208121 String[1]：发送情况返回 （当 errMsg 不为负值时该值有效 ） 格式（无换行符）： batchSendResp sendResp sms phone15000792799/phone smsID2c9281e22c5d9f77012c5da2d0b7001b/smsID /sms /sendResp sendResp sms phone15000792799/phone smsID2c9281e22c5d9f77012c5da2d0c0001c/smsID /sms /sendResp /batchSendResp . 获取上行 调用短信上行间隔时间不小于 30 秒。 名称 getSms 功能 获取上行短信，一次最多取 10 条。 接口方法 getSms(String account, String password) 输入说明 account 用户账号； password 用户密码（用 MD5 加密 ， 32 位，加密后字母全部为小 写 ， 例 如 ：“ “ 加 密 后 应 该 等 于“ cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确 ）。 三通运营平台 CTCOSS 接口手册 上海大汉三通网络通信有限公司 上海张江高科技园区浦东软件园 20 号楼 5 层 第 14 页 共 30 页 版权所有 (C) 20202033 网址： 全国热线： 4008208121 输出 说明 String[] 字符串数组 String[0]：输出参数，小于零时表示下发错误，详情见错误码 String[1]：返回上行短信（当 errMsg 不为负值时该值有效 ） 格式（无换行符）： mosms sms phone15000792799/phone contentTest MO! 测试 Deliver 消息 !/content /sms sms phone15000792799/phone contentTest MO! 测试 Deliver 消息 !/content /sms /mosms 没有上行时返回： mosms/mosms . 获取状态报告 调用短信状态报告间隔时间不小于 30 秒。 名称 getReport 功能 获取一条或者多条状态报告。 接口方法 getReport(String account, String password,MtNewMessage[] message) 输入说明 account 用户账号； password 用户密码（用 MD5 加密 ， 32 位，加密后字母全部为小 写 ， 例 如 ：“ “ 加 密 后 应 该 等 于“ cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确 ）； 三通运营平台 CTCOSS 接口手册 上海大汉三通网络通信有限公司 上海张江高科技园区浦东软件园 20 号楼 5 层 第 15 页 共 30 页 版权所有 (C) 20202033 网址： 全国热线： 4008208121 MtNewMessage，详情请参照 自定义数据结构： MtNewMessage,包含消息序号和手机号码的对象数组。 （ 只需要填写 smsId 和phoneNumber字段 ）。 输出说明 String[] 字符串数组 String[0]: 输出参数，小于零时表示下发错误，详情见错误码 String[1]: 返回状态报告（当 errMsg 不为负值时该值有效） 格式（无换行符）： smsReport sms phone13887787878/phone smsID2c9281e22bf60182020bf6025949001a/smsID stat0/stat /sms sms phone13887787879/phone smsID2c9dd1e22aa6018dd12bf60ff5949055/smsID stat0/stat /sms /smsReport 无状态报告时返回： smsReport/smsReport . 获取 余额 调用获取余额报告间隔时间不小于 30 秒。 名称 getBalance 功能 获取帐号余额。 接口方法 getBalance(String account, String password) 三通运营平台 CTCOSS 接口手册 上海大汉三通网络通信有限公司 上海张江高科技园区浦东软件园 20 号楼 5 层 第 16 页 共 30 页 版权所有 (C) 20202033 网址： 全国热线： 4008208121 输入说明 account 用户账号； password 用户密码（用 MD5 加密 ， 32 位，加密后字母全部为小 写 ， 例 如 ：“ “ 加 密 后 应 该 等 于“ cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确 ）。 输出说明 String[] 字符串数组 String[0]： 输 出参数，小于零时表示下发错误，详情见错误码 String[1]：返回账户余额（当 errMsg 不为负值时该值有效） 格式（无换行符）： userBalancesms0/smsmms43216/mms/userBalance . 短信 webservice 错误码 1：输入参数不正确，请检查账户，密码，等输入参数是否为空 2：账户不存在，请检查用户名密码是否正确 3：账户已经超过每日发送短信限制数量（当账户被限制每日发送量时有用） 4：客户端 ip 地址不正确（当需要 ip 校验时） 5： smsId 与数据库重复（下发短信时，如果 smsId 由客户端传入，该参数不能重复 ） 6：内容含有非法关键字，请检查下发内容。 7：对应的号码下发失败，下发号码为空或其他错误，导致该号码发送失败 8：账户余额不足 . WebService 接口（ xml 方式传输数据 ） 注意： 终端客户的接入方式设置为 WebService 接入时 才能使用此接口。 该接口数据输入输出均采用 xml格式封装的字符串 ，编码统一为 UTF8。 访问地址： 三通运营平台 CTCOSS 接口手册 上海大汉三通网络通信有限公司 上海张江高科技园区浦东软件园 20 号楼 5 层 第 17 页 共 30 页 版权所有 (C) 20202033 网址： 全国热线： 4008208121 . 短信下行 名称 submit 功能 发送一条或则多条内容相同的短信 接口方法 String submit (String message) 输入说明 message 参数 xml格式如下： ?xml version= encoding=UTF8? message accountadmin/account passwordbb43a2c4081bec02fca7b72f38e63021/password msgid2c92825934837c4d0134837dcba00150/msgid phones13111111111,13222222222,13333333333/phones content短信内容 /content subcode5555/subcode sendtime202001011230/sendtime /message 字段说明： account ： 用户账号 password： 账号密码 ， 需采用 MD5 加密 (小写 )，如： 加密后为bb43a2c4081bec02fca7b72f38e63021 msgid： 该批短信编号 (32位 UUID)，需保证唯一，可空 ，建议为空 phones： 接收手机号码 ，多个手机号码用英文逗号分隔，最多 500，不能为空 content： 短信内容 ， 最多 500个汉字 ，不能为空 subcode： 扩展子号码 ，可空 （验证格式和长度，不能超过 20 位） sendtime： 发送时间 ,格式 yyyyMMddHHmm,可空 (12 位数字，年月日时分，比如 202011180929) 三通运营平台 CTCOSS 接口手册 上海大汉三通网络通信有限公司 上海张江高科技园区浦东软件园 20 号楼 5 层 第 18 页 共 30 页 版权所有 (C) 20202033 网址： 全国热线： 4008208121 输出说明 返回的结果 xml格式 如下： ?xml version= encoding=UTF8? response m。