二次开发接口说明.docx

二次开发接口说明 目录 客户接口说明 错误!未定义书签。 短信二次接口技术 2 支持多种操作体统：WINDOWS、LINUX、UNIX 2 支持多种开发语言：C#、VB、delphi、VC++、ASP、JAVA、.NET 等 2 支持编码格式：UTF-8 编码 3 第一章 发送接口 3 请求地址 3 参数说明 3 返回值 3 第二章 余额及已发送量查询接口 5 请求地址 5 参数说明 5 返回值 5 第三章 非法关键词查询 7 请求地址 7 参数说明 7 返回值 7 第四章 状态报告接口 9 请求地址 9 参数说明 9 返回值 9 错误返回值——状态报告请求错误返回格式及对应值 10 第五章 上行接口 10 请求地址 10 参数说明 10 返回值 10 错误返回值——回复请求错误返回格式及对应值 11 短信二次接口技术 随着移动商务应用和 3G 无线技术的加速普及和深入发展与用户需求的变化，短信用户群由时尚人群不断向企业、行业用户扩展。短信作为一种实用、方便、廉价的通信手段，越来越多 地成为企业、行业人士日常工作不可或缺的通讯工具；同时，短信应用范围也由通用服务向企 业、行业应用领域扩展。短信应用不再局限于交互游戏等娱乐方式，它已经介入到企业办公、 银行、证券、保险、交通、教育、社保、数据采集等领域，已成为企业、行业应用密不可分的 一部分。面向企业、行业的短信业务逐渐成为短信应用的一个重要组成部分，越来越多的企业 开始利用短信平台开展各种短信增值业务如：OA 管理系统、短信商业信息发布系统、短信客户关系管理系统、短信呼叫中心、进销存系统、短信防伪、生产管理系统、短信数据采集等。业 务系统、网站、客户管理系统、进销存系统、OA、生产管理系统。手机也势必会成为企业信息 化管理、移动商务办公的又一大信息终端。 支持多种操作体统：WINDOWS、LINUX、UNIX 支持多种开发语言：C#、VB、delphi、VC++、ASP、JAVA、.NET 等 支持开发方式：Http 协议 支持编码格式：UTF-8 编码第一章 发送接口 请求地址 请求地址是客户接口程序调用时请求的url 地址，采用的是 http post 接口，地址是 客户端地址+ 例如：:8888/; 入口地址一般不会发生变化，当发生变化的时候，会通知接口用户 参数说明 :8888/?action=send 参数名称userid account password mobile content sendTime action checkcontent taskName countnumber mobilenumber 含义 企业 id 发送用户帐号发送帐号密码全部被叫号码 发送内容 定时发送时间 发送任务命令 是否检查内容包含非法关键字 任务名称 号码总数量 手机号码数量 说明 企业 ID 用户帐号，由系统管理员用户账号对应的密码 发信发送的目的号码 .多个号码之间用半角逗号隔开 短信的内容 为空表示立即发送，定时发送格式 2010-10-24 09:08:10 设置为固定的:send 当设置为 1 时表示需要检查，默认 0 为不检查 本次任务 描述 100 个字以内 可以为空本次提交的号码总数量 本次提交的手机号码数量 telephonenumber 小灵通或座机号码数 例如： 本次提交的小灵通或座机号码数数量 action=senduserid=12account= 账 号 password= 密 码 mobile=,content= 内 容sendTime=taskName= 本 次 任 务 描 述checkcontent=1mobilenumber=10countnumber=12telephonenumber=2 返回值 在接收到客户端发送的 http 请求后，返回以 xml 的方式返回处理结果。格式为： ?xml version=1.0 encoding=utf-8 ? returnsms returnstatusstatus/returnstatus ---------- 返回状态值：成功返回 Success 失败返回：Faild messagemessage/message 返回信息：见下表 remainpoint remainpoint/remainpoint 返回余额 taskIDtaskID/taskID 返回本次任务的序列 ID successCountssuccessCounts/successCounts --成功短信数：当成功后返回提交成功短信数 /returnsms 返回信息提示 ok 用户名或密码不能为空 发送内容包含 sql 注入字符用户名