企业短信平台企业api接口使用手册..doc

企业短信平台企业API接口说明 2006-12-6 版本 时间 更新内容 更新人 1.0 2006-6-20 文档成立 顺炽国 2.0 2006-12-6 1.扩展发送接口函数,增加了如下功能: 指定特服号发送(需要配置多个特服号,或配置的特服号支持扩展),否则默认用单一特服号发送; 支持发送异网短信,即可以用企业绑定的电话号码发送异网短信; 支持多号码发送,号码间用逗号分隔,号码类别(即各运营商号码,如:小灵通\手机)可混合发送同一条信息; 支持回执确认的操作. 支持定时发送的操作; 返回格式更新为XML的模式,以存放更丰富的返回信息,如:发送状态报告,错误详细信息,发送的任务ID(便于以后查询状态); 2.增加一个根据发送任务ID取发送状态的接口函数,便于查询此发送任务的短信发送结果; 顺炽国 目 录 1 企业API接口 4 1.1 接口函数说明 4 1.1.1 发送消息函数SendMessage 4 1.1.2 接收消息函数RecvMessage 6 1.2 企业接口调用方式 8 1.2.1 ASP中的Jscript和VbScript的调用 8 1.2.2 C#中的调用 8 1.2.3 Javascript的调用 9 1.2.4 Java的调用方式 9 企业API接口 企业API接口的实现使用了WebService的方式，企业用户通过调用WebService的指定接口函数以达到发送和接收短信的目的； 企业接口的服务页面为WebService/EntInterface.asmx，如果WEB服务器地址为：42:9090那么访问WebService的地址就为： 42:9090/WebService/EntInterface.asmx 要查看接口的定义的话则在连接地址下面增加“?WSDL”，即： 42:9090/WebService/EntInterface.asmx?WSDL 接口函数说明 企业接口中提供了三个函数，如下： string SendMessage (string strLoginCode, string strPass, string strSpNum, string strRecvNum, string strMsg, int bConfirm, string AtDate) string RecvMessage (string strLoginCode, string strPass) string GetStatus (string strLoginCode, string strPass, string strSendID) SendMessage 函数为发送消息的函数 RecvMessage 函数为接收企业用户消息的函数 GetStatus 函数为检测发送流水的消息函数 发送消息函数SendMessage 函数定义如下： string SendMessage (string strLoginCode, string strPass, string strSpNum, string strRecvNum, string strMsg, int bConfirm, string AtDate) 函数参数有七个： 参数名 说明 strLoginCode 分配给企业用户的登录名 strPass 分配给企业用户的对应密码 strSpNum 企业用户发送短信时所使用的特服号,如果分配了多个特服号,可使用分配的任意一个,如果特服号支持扩展,则可以在分配的特服号上扩展其它号码,例如:分配给A企业的特服号为220355和220366,其中220355可支持扩展号码,220366不支持扩展号码,那么,在发送的时候,可以使用220355,220366中的任何一个发送信息,也可以使用220355+扩展的数字来发送信息,不过220366则只能以220366来发送信息;(如果需要使用模拟号码池中号码进行轮询，特服号这列填空即可。) strRecvNum 短信接收号码,可以为多个接收号码,号码间用分号”;”或逗号”,”分隔.可支持最大4096个字符的号码群,超过此长度的号码群将被截断,所以在群发的时候最好不要超过此长度. 对于接收的号码不作限制,可以是任何运营公司的号码,不过对于在系统黑名单中的用户,是默认不发送出去的,同时,对于各个运营商的号码会分拆成不同的任务发送出去,所以对于发送不同运营商号码的群发,系统会返回多个流水号. strMsg 要发送的实际内容,长度不能超过255个字符,超过各运营商默认短信的默认长度,会被拆分成多条短信发送,根据配置情况会计一次费用或多次费用. bConfirm 是否需要取到用户回执:0-不需要,1-需要; 建议在特别情况下才需要,否则默认都输入0