短信SDK通用版接口文档

用版接口调用说明- 0 一次修订时间：2011011011用版接口调用说明- 1 仔细阅读信息安全责任保证条款 . 全信息责任条款 . 意事项： . . 回集合对照表 . 册(信息必须真实, 短信出现问题联系不上使用者后果自负.) . 询余额 . 值 . 送短信 . 收短信 . 性发送 . .1 回集合对照表 .1 送短信 .1 收短信 .1 .2 用流程 .2 册 .2 询余额 .3 件序列号，卡号,密码) .3 送短信 .4 送个性短信 .4 收短信 .5 改密码 .5 收子号回复短信 .5 销账户 .6 送说明 .6 单发说明 .6 群发说明 .6 码说明 .6 短信说明 .6 短信扣费说明 .6 收说明 .7 加说明 .7 用版接口调用说明- 2 口地址 .7 它说明 .7 重声明 .7 全信息责任条款本人/本公司在使用本软件过程中，将严格遵守国家相关法律、法规、保证本公司信息发布的安全，并切实做到：（1） 建立健全本公司信息发布的内部保障制度、信息安全保密制度、用户信息安全管理制度，建立健全本公司信息安全责任制度和信息发布的审批制度，严格审查本公司产品所发布信息。（2） 严格遵守互联网信息服务管理办法 ，对用户编辑的信息内容进行把关，保证信息内容的健康、合法。 （3） 明确本企业的客户群和客户范围，所有通讯受众必须是自愿且明确同意接受企业服务。（4） 若发送未经用户允许的信息等所造成的影响、投诉等一切损失与本软件版权方无关、由本人/本公司承担全部责任；同时，本人/本公司也应承担若因此给本软件版权方造成的全部损失。（5） 不利用本软件制作、复制、发布、传播含有下列内容的信息： 反对宪法所确定的基本原则的； 危害国家安全，泄露国家秘密，颠覆国家政权，破坏国家统一的； 损坏国家荣誉和利益的； 煽动民族仇恨、民族歧视，破坏民族团结的； 破坏国家民族宗教政策，宣扬邪教和封建迷信的； 散布谣言，扰乱社会秩序，破坏社会稳定的； 散布淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪的； 侮辱或者诽谤他人，侵害他人合法权益的； 含有法律、行政法规禁止的其他内容的；（6） 自信息发布六个月内不修改删除信息发送日志内容，日志记录的备份应至少保持 6 个月以上，在国家机关进行依法查询时，予以提供。用版接口调用说明- 3 -（7） 若发现本公司所发布的信息明显属于上述第（5）款所列内容，保证立即停止传输，并向国家有关机关报告。 （8） 对本公司所发布的信息一时难以辨别是否属于以上所列内容之一的，应报相关主管部门审核同意后再发布。（9） 对客户的个人信息保密，未经客户同意不得向他人泄漏，但法律规定的除外。本人/本公司保证：在使用本软件进行信息发布活动中，服从监督和管理；若未做到上述一至八条，本人/本公司愿意承担由此引起的一切法律责任，并接受相应的处罚。意事项：同一个序列号提交，必须提交到同一个 务器；同一个序列号提交，必须等上一批次返回后再提交下一批次；相同内容，不同手机号，请使用 次建议 3000 个手机号；不同内容，不同手机号，请使用 次建议 1000 个手机号；为了便于技术与技术之间的沟通及后期维护事宜的及时通知,请负责开发人员将您的联系方式发至 者直接添加 术支持):531631044、口2.1 回集合对照表 返回值 返回值说明 问题描述1 没有需要取得的数据 取用户回复就出现 1 的返回值,表示没有回复数据号/密码不正确 额不足 直接调用查询看是否余额为 0 或不足据格式错误数有误 看参数传的是否均正常,请调试程序查看各参数限受限 该序列号是否已经开通了调用该方法的权限量控制错误展码权限错误 该序列号是否已经开通了扩展子号的权限容长度长 短信内容过长部数据库错误用版接口调用说明- 4 列号状态错误 序列号是否被禁用有提交增值内容务器写文件失败件内容 码错误回报告库参数错误有权限 如发送彩信仅限于 次提交没有等待返回不能继续提交默认不支持多线程止同时使用多个接口地址 每个序列号提交只能使用一个接口地址同手机号，相同内容重复提交p 鉴权失败 提交的 是所绑定的 册(信息必须真实, 短信出现问题联系不上使用者后果自负.)参数名称 说明 备注件序列号 格式 商务处获得码 6 位 明文 必填 必填业 必填司名称 必填系人 必填话 必填动电话 必填件地址 必填真 必填址 必填政编码 必填用版接口调用说明- 5 业签名 (2字符) 可空注: 式:文本格式: 0 成功。2.3 询余额参数名称 说明 备注件序列号 格式 码 sn+32 位大写 密文 +表示连接函数返回值：额）示例：序列号 码 123456参数输入：3式:文本格式:值参数名称 说明 备注件序列号 用版接口调用说明- 6 码 123456 此处为明文值卡号 充值卡号 由商务处获得值卡密码 充值密码 由商务处获得函数返回值:式:文本格式:0 成功。2.5 送短信参数名称 说明 是否必须 备注件序列号 是 格式 码 是 sn+32 位大写密文机号 是 必填(支持 10000 个手机号,建议注册组件 方法:开始->运行->输入(然后在控制台输入 格 c:：路径为 所在路径)调用 法注册帐号发送短信等其它方法允许一个帐号在一台服务器上使用，如需多台使用，请参看 口;同一帐号，只需注册一次，如不更换服务器，不需要注销；用版接口调用说明- 12 册参数名称 说明 备注件序列号 格式 码 6 位 必填 必填业 必填司名称 必填系人 必填话 必填动电话 必填件地址 必填真 必填址 必填政编码 必填返回值 用重复注册,如需更换服务器先在本地上注销，然后再在其它电脑上注册。询余额函数功能：查询余额参数名称 说明 备注件序列号 件序列号，卡号,密码) 用版接口调用说明- 13 值输入参数：参数名称 说明 备注件序列号 值卡号 商务提供码 商务提供函数返回值： 送短信 函数功能：发送短信参数名称 说明 是否必须 备注件序列号 是 格式 机号 是 必填(支持 10000 个手机号,建议<=5000)多个英文逗号隔开容 是 支持长短信(详细请看长短信扣费说明)展码 否 例如：123（非网络版置空）时时间 否 例如：20106:27:03（非定时置空） 送个性短信 参数名称 说明 是否必须 备注件序列号 是 格式 机号 是 必填(建议一次最多提交 1000 个)容 是 支持长短信(详细请看长短信扣费说明)展码 否 例如：123（非网络版置空）如： 2010:23:20（非定时置空）要 方法,请直接调用 的 用版接口调用说明- 14 入 、手机号以英文逗号隔开2、发送内容 码后，以英文逗号隔开，个数和手机号个数一致3、扩展码可以为空，单个，或多个（以英文逗号隔开，个数和手机号个数一致）4、定时时间可以为空，单个，或多个（以英文逗号隔开，个数和手机号个数一致）返回结果: 收短信 函数功能：接收短信输入参数：参数名称 说明 备注件序列号 要自定义接收变量,详看 ：信息接收后不能再次接收。 改密码 函数功能：更改密码输入参数：参数名称 说明 备注件序列号 密码 为 6 位函数返回值：收子号回复短信 函数功能：接收短信输入参数：参数名称 说明 备注用版接口调用说明- 15 件序列号 号码 根据权限限制长度函数返回值：要自定义接收变量,详看 1：每个子号只能接收自己子号的信息，如特服号为 12345,子号 1 只能接收 123451 号上的短信，空串可接收所有子号 信息；信息接收一次便不能再接收。注 2：根据用户需求由客服开通，子号以数字 1 开始，不得以 0 开头，如 01,001销账户函数功能：注销输入参数：参数名称 说明 备注件序列号 单发说明（每次提交只有一个手机号）时，在一个时间点需要发送 N 条相同内容不得超过 20 参考方法;群发说明(提交内容相同)时,请参看 使用方法,码说明接口所有方法都是 码，短信说明一次提交内容最大是 600 字节 300 汉字(建议 290 汉字) 短信扣费说明如果一次提交小于等于 70 字符 系统会默认为一条短信发出 扣费一条如果大于 70 字符 系统会默认为长短信处理 此时根据长短信前边会加(1/2) 或用版接口调用说明- 16 )的标志 此时扣费按 65 字符扣一条 所以 198 字符 是 65*3+3 扣费 4条 对方如果手机支持长短信则收到一条 如果不支持长短信 则收到四条(建议内容不超过 290 字符) 纯单字节是 140 一条,没有长短信的概念。6 接收说明 接收短信间隔最少为 5 秒；接收短信每条以回车换行符(n)分割，接收内容请进行 码;7 口地址地址： ，如 号第一次需要调用 合使用， 连续使用不得超过 10 次/天;者 仅方法名不同);一时间点) 推荐 体请参看 法介绍)重声明1. 禁止相同的内容多个手机号连续一条一条提交. 否则禁用帐号，须等上一批提交返回后再提交下一批5. 请客户提供外网服务器 便于绑定 送，提高账号的安全性！