SMS运营服务WebService 接口.doc

SMS API调用使用指南（WebService）上海傲融软件技术有限公司2008年6月一、 发送短信函数名称: SendSmsToServerXML参数结构:XML结构类型缺省值长度/最大值必填备注LoginXMLY用户帐号与密码LoginUserIDString“”20Y用户帐号LoginPasswordString“”20Y用户密码SendTaskListXMLY包括多个SendTaskSendTaskListTotalNumint01000Y短信个数.最大值1000.如果个数太多,请分开传输.SendTaskListSendTaskXMLY一个发送任务SendTaskListSendTaskClientTaskIDint0Int最大值Y客户端TaskID,标志唯一一条短信记录.用于查询发送结果SendTaskListSendTaskSmsNumberString“”20Y短信号码.SmsOptionsXML作业参数设置SmsOptions Priorityint12优先级.1-低,2-高SmsOptions ContentString“”210短信内容Soap消息体:12345abcd123102168416178 10216841617800 表明调用函数SendSmsToServer返回结果XML参数结构:XML结构类型缺省值长度/最大值必填备注HeaderXMLY消息头HeaderErrorFlagint020Y调用是否成功.0-成功.其它-失败,参考表AHeaderReturnMessageString“”20Y调用结果信息JobNoString“”20Y作业号TotalNumint01000Y总短信个数ValidNumint01000Y有效短信个数Soap消息体:intstringstringintint二、 查询发送清单函数名称:QueryResultForSmsTask查询所有未获取的清单注：如果查询条件都不填，即查询所有发送清单；如果有查询条件，条件是”与”的关系。XML参数结构:XML结构类型缺省值长度/最大值必填备注LoginXMLY用户帐号与密码LoginUserIDString“”20Y用户帐号LoginPasswordString“”20Y用户密码Soap消息体: 00000001 111111 调用函数QueryResultForSendTask反馈信息如下:注:服务端做流量控制,每次不能超过多少条,防止传输太慢,影响服务器性能。 建议客户如果SendSmsResultNum=1000,继续调用,直到SendSmsResultNum1000,或者缩小查询范围。XML参数结构:XML结构类型缺省值长度/最大值必填备注HeaderXMLY消息头HeaderErrorFlagint020Y调用是否成功.0-成功.其它-失败,参考表AHeaderReturnMessageString“”20Y调用结果信息SendSmsResultNumint01000Y查询到的任务个数SendSmsResultListXML查询到的任务列表SendSmsResultList SendSmsResultXML查询到的任务SendSmsResultList SendSmsResultClientTaskIDint0Int最大值Y客户端任务IDSendSmsResultList SendSmsResultresultint0100Y发送结果.0-成功,其它-不成功.参考表CSendSmsResultList SendSmsResultNumberOfSectsint01000Y发送段数SendSmsResultList SendSmsResultBillingFeedouble0.0010000Y发送费用.单位:元,保留两位小数.Soap消息体:intstring10intintint double intintint String 附录Appendix表AHeader ErrorFlag 通信层返回的结果值说明0成功-1用户名，密码认证错误-2该帐号连接已存在-3参数输入有误-9IP地址错误-10Xml错误 -11无合格号码-12参数有误-14新密码不能为空-15余额不足-16短信内容为空-17短信内容不合法-18短信段数计算错误-99未知错误表C 任务状态值说明0发送成功17余额不足32无应答64禁止发送用户指南API接入注意事项为了提高系统的响应速度，建议如下：n 没有等发送任务，请不要与服务器连接n 没有等待查询任务，请不要与服务器连接n 由于短信需要一段时间发送，建议有必要时，您每隔一分钟以上与服务器连接查询发送清单1. 如果不输入 查询条件 返回 所有 短信记