35SMS运营服务WebService 接口

WebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone]SMSAPI调用使用指南（WebService）上海傲融软件技术有限公司2008年6月WebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone]一、发送短信函数名称:SendSmsToServerXML参数结构:XML结构类型缺省值长度/最大值必填备注LoginXMLY用户帐号与密码LoginUserIDString“”20Y用户帐号LoginPasswordString“”20Y用户密码SendTaskListXMLY包括多个SendTaskSendTaskListTotalNumint01000Y短信个数.最大值1000.如果个数太多,请分开传输.SendTaskListSendTaskXMLY一个发送任务SendTaskListSendTaskClientTaskIDint0Int最大值Y客户端TaskID,标志唯一一条短信记录.用于查询发送结果SendTaskListSendTaskSmsNumberString“”20Y短信号码.SmsOptionsXML作业参数设置SmsOptionsPriorityint12优先级.1-低,2-高SmsOptionsContentString“”210短信内容Soap消息体:?xmlversion=1.0encoding=gb2312?WebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone]SmsInfoxmlns==:schemaLocation=……SendTaskClientTaskID1/ClientTaskIDSmsNumber02168416178/SmsNumber/SendTask/SendTaskListSmsOptionsPriority0/PriorityContent0/Content/SmsOptions/SmsInfo表明调用函数SendSmsToServer返回结果XML参数结构:XML结构类型缺省值长度/最大值必填备注HeaderXMLY消息头Headerint020Y调用是否成功.0-成功.其WebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone]ErrorFlag它-失败,参考表AHeaderReturnMessageString“”20Y调用结果信息JobNoString“”20Y作业号TotalNumint01000Y总短信个数ValidNumint01000Y有效短信个数Soap消息体:?xmlversion=1.0encoding=gb2312?soap:Envelopexmlns:xsi=:xsd=:soap=:BodyHeaderErrorFlagint/ErrorFlagReturnMessagestring/ReturnMessage/HeaderSendSmsToServerResponseSendSmsToServerResultJobNostring/JobNoTotalNumint/TotalNumValidNumint/ValidNum/SendSmsToServerResult/SendSmsToServerResponse/soap:Body/soap:Envelope二、查询发送清单函数名称:QueryResultForSmsTask查询所有未获取的清单注：如果查询条件都不填，即查询所有发送清单；如果有查询条件，条件是”与”的WebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone]关系。XML参数结构:XML结构类型缺省值长度/最大值必填备注LoginXMLY用户帐号与密码LoginUserIDString“”20Y用户帐号LoginPasswordString“”20Y用户密码Soap消息体:?xmlversion=1.0encoding=gb2312?SmsInfoxmlns==:schemaLocation=调用函数QueryResultForSendTask反馈信息如下:注:服务端做流量控制,每次不能超过多少条,防止传输太慢,影响服务器性能。建议客户如果SendSmsResultNum=1000,继续调用,直到SendSmsResultNum1000,或者缩小查询范围。XML参数结构:XML结构类型缺省值长度/必填备注WebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone]最大值HeaderXMLY消息头HeaderErrorFlagint020Y调用是否成功.0-成功.其它-失败,参考表AHeaderReturnMessageString“”20Y调用结果信息SendSmsResultNumint01000Y查询到的任务个数SendSmsResultListXML查询到的任务列表SendSmsResultListSendSmsResultXML查询到的任务SendSmsResultListSendSmsResultClientTaskIDint0Int最大值Y客户端任务IDSendSmsResultListSendSmsResultresultint0100Y发送结果.0-成功,其它-不成功.参考表CSendSmsResultListSendSmsResultNumberOfSectsint01000Y发送段数SendSmsResultListSendSmsResultBillingFeedouble0.0010000Y发送费用.单位:元,保留两位小数.Soap消息体:?xmlversion=1.0encoding=gb2312?soap:Envelopexmlns:xsi=:xsd=:soap=:BodyHeaderWebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone]ErrorFlagint/ErrorFlagReturnMessagestring/ReturnMessage/HeaderQueryResultForSendTaskResponseQueryResultForSendTaskResultSendSmsResultNum10/SendSmsResultNumSendSmsResultListSendSmsResultClientTaskIDint/ClientTaskIDresultint/resultNumberOfSectsint/NumberOfSectsBillingFeedouble/BillingFee/SendSmsResult……SendSmsResultClientTaskIDint/ClientTaskIDresultint/resultNumberOfSectsint/NumberOfSectsBillingFeeString/BillingFee/SendSmsResult/SendSmsResultList/QueryResultForSendTaskResult/QueryResultForSendTaskResponse/soap:Body/soap:Envelope附录Appendix表A—HeaderErrorFlag通信层返回的结果值说明WebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone]成功-1用户名，密码认证错误-2该帐号连接已存在-3参数输入有误-9IP地址错误-10Xml错误-11无合格号码-12参数有误-14新密码不能为空-15余额不足-16短信内容为空-17短信内容不合法-18短信段数计算错误-99未知错误表C任务状态值说明0发送成功17余额不足32无应答64禁止发送用户指南API接入注意事项为了提高系统的响应速度，建议如下：没有等发送任务，请不要与服务器连接没有等待查询任务，请不要与服务器连接由于短信需要一段时间发送，建议有必要时，您每隔一分钟以上与服务器连接查询发送清单WebService开发接口技术方案书上海傲融软件技术有限公司Tel:8621-516959888Fax:[phone].如果不输入查询条件返回所有短信记录没有被查询过的短信已完成的任务.如果份数大于1000条,则继续查询.2.如果输入查询条件返回符合该条件的所有的包括已查询过的已完成的任务,条件是与的关系.如果份数大于1000条,请缩小查询范围.