网页合作伙伴接口文档1.docVIP

集团短信HTTP接口开发开发文档 代理热线: 021 公司网址: HYPERLINK 第 PAGE 8 页 共 NUMPAGES 8 页 System Software Service 企信通接口开发文档 (HTTP接口版) 重要说明： 1、使用特点及开发难度： 在网页程序或应用程序中直接调用URL语句来完成短信的功能。 开发难度：简单，需要进行程序开发。 2、特别说明: 本文包含的信息代表维那公司目前对本文所涉及内容的观点，由于用户需求、市场和 产品情况的不断变化，本文中的信息并不代表维那公司未来的观点，维那公司不能保证本 文信息在未来时间的有效性。本文信息若有变动，恕不另行通知。 3、公司服务器地址： 服务器 服务器地址 备注 一 95 适用于电信/网通用户 二 92 适用于电信/网通用户 三 S 适用于电信/网通用户 4、在下面所有访问页面前面加上这个路径： http:// 95 (接口服务器地址)＋各接口短信文件 或http:// 92 (接口服务器地址)＋各接口短信文件 或（接口服务器地址）＋各接口短信文件 推荐使用域名，防止当此机房故障时，自动转换到其它正常的机房中。 二、接口短信文件： 1、群发短信(/send/gsend.aspx),如需开通长短信请联系客服人员。 参 数 参数名 含义 是否必填 示例 备注 name 企业用户登陆名称 是 ? 　 pwd 企业用户登录密码 是 ? 　 dst 群发目标手机号 是 ? 手机（联通移动）、小灵通必须分开单独为一组进行提交，号码之间必须用英文逗号分割,最后一个手机号后不加逗号, 必填,请少于70个号码。 msg 发送短信内容 否 ? 为不超过60个汉字、字符、数字的字符串，小灵通号码不超过42个字。超过的字符将直接返回失败。“字”解释：1个数字或字母或符号为1字，1个汉字为1字，以字为计，非字节。 time 定时时间 否 200505241713表示此条短信定时在2005年5月24日17点13分发出。 默认为空，为立即发送。定时发送格式: YYYYMMDDHHMM；15位时间表示，不符合规则的将立即进行发送。 sender 长号码 否 您的特服代码为0888008，想让此条短信的发送者为088800800，则sender=00即可；可填,值为空则默认为您的特服代码。 纯数字的字符串，长度9,完整的特服号码长度17，在短信分配的特服代码后附加的数字。 此返回值发送到用户提供的url上 返 回值 参数名 含义 类型 示例 备注 num 已成功提交短信条数 数字 ? =0，为发送失败；0，为正确结果，调用者应该根据此值唯一判断短信提交成功与否。 success 成功提交的手机号 字符 ? 用英文逗号分割 faile 发送失败的手机号 字符 ? 用英文逗号分割 err 发送错误原因 字符 ? 仅供参考 errid 具体错误编码 数字 ? 　 示例 示例 具体示例 95/send/gsend.aspx?name=companypwd=1515dst= 1393710***4,1393710***5msg=你好吗 返回结果 num=2success=1393710***4,1393710***5faile=err=发送成功errid=0 2、接收短信： = 1 \* GB3 ①、主动接收单条短信：（/send/readsms.aspx）： (主动读取用户上行回复的短信，每次只能读取一条短信。 如果有多条未读短信，请重复 调用本接口读取。读取间隔请大于5秒/次。) 参 数 参数名 含义 是否必填 示例 备注 name 企业用户登陆名称 是 ? name pwd 企业用户登录密码 是 ? pwd 此返回值发送到用户提供的url上,参数顺序不固定,请根据参数名判别。 返 回值 参数名 含义 类型 示例 备注 id 短信编号 数字 ? =0,为读取失败或当前没有未读短信；其它值为成功读取短信编号。 err 错误原因 字符 ? 如果成功此项为空，仅供参考。 src 回复短信的手机号码 数字 ? ? msg 回复短信的内容 字符 ? ? dst 回复的特服号码 数字 ? ? time 用户回复短信时间 数字 200505241713表示用户在2005年5月24日17点13分发的短信 格式: YYYYMMDDHHMM smsid 短信接收ID 数字 smsid=15155表示从