学位办短信平台接口说明.docVIP

学位办短信平台接口说明 短信平台的基本工作原理 短信平台采用WebService的形式提供服务，后台用ASP实现。目前只支持soap形式的调用，不支持POST或GET形式的调用。用户通过短信平台完成短信的收发任务。 短信平台是多用户系统，每个用户有一个用户名和密码。用户使用平台前需先登录。平台采用ASP SESSION的方法保存用户的数据，所以客户端应该保留平台产生的Cookie数据(保留第一次访问时的Cookie)，并且每次都应该把cookie数据发送给服务器，以保持登录状态。 用户每次使用平台，要求必须先登录，并且在使用完成以后，必须退出登录。 使用短信平台发送信息的典型顺序是： 用户登录 创建短信发送任务(短信内容)，获取平台提供的任务号 发送短信(指定任务号和接收的手机号码) 关闭短信任务 退出登录 短信平台部署的地址是： 后面分别详细介绍各接口信息。 平台返回数据格式 平台返回客户端SOAP的数据格式。举例如下： SOAP信封 ?xml version=1.0 encoding=UTF-8 ? SOAP-ENV:Envelope SOAP-ENV:encodingStyle=/soap/encoding/ xmlns:SOAP-ENV=/soap/envelope/ xmlns:xsd=/2001/XMLSchema xmlns:xsi=/2001/XMLSchema-instance xmlns:SOAP-ENC=/soap/encoding/ SOAP-ENV:Body SOAP消息体 /SOAP-ENV:Body /SOAP-ENV:Envelope SOAP Fault消息的格式 SOAP-ENV:Fault faultcode xsi:type=xsd:stringclient/faultcode faultactor xsi:type=xsd:string/faultactor faultstring xsi:type=xsd:string#21442;#25968;#25968;#30446;#19981;#36275;/faultstring detail xsi:type=xsd:string/detail /SOAP-ENV:Fault 返回单个值的消息体 ns1:loginResponse xmlns:ns1= return xsi:type=xsd:int 1/return /ns1:loginResponse 返回数组的消息体 VBSCRIPT是弱类型的，所以返回的数组，元素类型取anyType。 ns1:smsSendByTaskResponse xmlns:ns1= return xsi:type=SOAP-ENC:Array SOAP-ENC:arrayType=xsd:anyType[10] item xsi:type=xsd:int20/item item xsi:type=xsd:stringadmin/item item xsi:type=xsd:int0/item item 2010-3-18 19:00:53/item …… /return /ns1:smsSendByTaskResponse 返回“数组的元素还是数组”的消息体 ns1:smsSendByTaskResponse xmlns:ns1= return xsi:type=SOAP-ENC:Array SOAP-ENC:arrayType=xsd:anyType[10] item xsi:type=SOAP-ENC:Array SOAP-ENC:arrayType=xsd:anyType[6] item xsi:type=xsd:int20/item item xsi:type=xsd:stringadmin/item …… /item item /item …… /return /ns1:smsSendByTaskResponse 用户登录接口 接口形式：login (login, password) 返回数据：登录成功返回1 失败返回0 出错时，返回soapFault 检查登录状态 接口形式：checklogin 返回数据：已登录返回1 未登录返回0 出错时，返回soapFault 退出登录 接口形式：logout 返回数据：返回1 出错时，返回soapFault 创建短信任务 接口形式：smscreatetask(smsContent,ifCreateSerialNO,serialNOTaskID) 参数说明： smsContent:短信内容，不超过250字 if