北京互创时代彩网关接口.docVIP

彩信网关接口说明 2010年11月  目录 一、接口说明 3 1. Web Service接口 3 1.1.GetBatchSendID获取群发标识 3 1.2.GetBlackWords获取屏蔽词 3 1.3.SendEx发送短信 3 1.4.GetBalance查询余额 4 1.5.QuerySms查询上行 5 1.6.QuerySmsEx查询上行 5 1.7.QuerySmsExComplete确认已收到上行 6 1.8. GetSmsStateEx按用户名获取状态报告 7 1.9.SetPassword修改密码 7 2. HTTP接口 8 2.1.GetBatchSendID获取群发标识 8 2.2.GetBlackWords获取屏蔽词 8 2.3.SendEx发送短信 8 2.4.GetBalance查询余额 10 2.5.QuerySms查询上行 10 2.6.QuerySmsEx查询上行 11 2.7.QuerySmsExComplete确认已收到上行 13 2.8.GetSmsStateEx按用户名获取状态报告 13 2.9.SetPassword修改密码 16 3. 错误号说明 16 3.1.错误号码描述 16 三、被动接收上行短信 17 3.1.上行短信URL参数定义 17 四、被动接收状态报告 17 4.1.状态报告URL参数定义 17 五、注意事项 18  一、接口说明 1. Web Service接口 .使用Microsoft Visual Studio开发环境时: 单击”项目(Project)”菜单的”添加WEB引用(Add Web Reference)” 输入下面的WSDL地址然后回车 接口加载完成后,将右侧的默认命名空间复制到剪贴板 单击”添加引用(Add Reference)” 在需要调用接口的类中引用刚才复制到剪贴板的命名空间 声明一个实例,然后按需求调用实例的SendEx等方法即可 WSDL：:8080/mmsService/Service.asmx?wsdl 地址：:8080/mmsService/Service.asmx 1.1.AddTask添加任务单 AddTaskResp AddTask(string UserId, string Password, int BizType, string Title, string Content) 功能：新增彩信任务单，当成功后，可使用返回的任务编号提交手机号码 参数： 参数 描 述 UserID 用户编号(必填)，由代理商提供 Password 用户密码(必填)，由代理商提供 BizType 业务代码(必填)，由代理商提供 Title 彩信标题(必填) Content 彩信内容 1、 彩信由帧组成，最多10帧。每帧可以含有图片、声音、文本各一，统称为资源。 2、 内容由最多30个资源组成，多个资源用半角分号(;)分隔。 3、 每个资源内部包含三个信息，分别是：帧号，类型，内容（base64编码）。这三个信息用半角逗号(,)分隔。 4、 帧号取值范围：1-10。 5、 类型支持：txt（文本）、gif（图片）、jpg（图片）、mid（声音）、amr（声音） 6、 同一帧不能含有多张图片、多个声音、多个文本，当有重复时前面的将被覆盖。 7、 图片尺寸要求长宽都不超过240像素。 8、 资源内容总长不能超过40K。（编码前） 返回值： 参数 描 述 Result 0代表提交成功，否则请查阅错误号说明 ErrorDesc 错误描述 TaskID 任务编号 BlackWords 标题或内容中含有的屏蔽词 内容编码示例，您可以用您的编解码函数尝试将下面的解码并查看解码后是否可以顺利查看，以验证编解码函数是否正确： 1,txt,5L2g5aW9;1,jpg,/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/2wBDAQICAgMDAwYDAwYMCAcIDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAz/wAARCAAQABADASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGR