动力思维web版乐信SDK接口文档

动力思维专业源自专注—乐信短信平台河南省动力思维信息技术有限公司400-6699-521动力思维web版乐信SDK接口文档beta1.0动力思维AllRightsReserved

1. 说明 31.1. 提交方式与编码 31.2. 请求地址 31.3. 提交业务限制 31.4. 短信回执、账单 32. 主体协议 32.1. 发送短信 32.1.1. 发送地址 42.1.2. 发送参数 42.1.3. 发送响应Json格式 42.1.4. 发送响应xml格式 52.1.5. 发送响应string格式 62.2. 查询余额 62.2.1. 请求地址 62.2.2. 发送参数 62.2.3. 发送响应Json格式 62.2.4. 发送响应xml格式 72.2.5. 发送响应string格式 72.3. 短信报告查询 72.3.1. 请求地址 72.3.2. 发送参数 82.3.3. 发送响应Json格式 82.3.4. 响应xml格式 82.3.5. 响应String格式 92.4. 回复短信查询 92.4.1. 请求地址 92.4.2. 发送参数 102.4.3. 发送响应Json格式 102.4.4. 发送响应xml格式 102.4.5. 发送响应string格式 112.5. 回执推送 112.5.1. 推送地址 112.5.2. 推送参数及说明 112.5.3. 推送返回响应 112.6. 回复推送 122.6.1. 推送地址 122.6.2. 推送参数及说明 122.6.3. 推送返回响应 12说明提交方式与编码http请求都应以POST形式提交,编码为UTF-8请求地址请求地址(host)为:/sdk/不同的协议拥有不同的提交地址方式是在以上地址后面增加响应的地址提交业务限制单个短信数据包提交最多支持5000个号码,相同内容请拼接号码提交1分钟内提交短信数据包数量不能大于100个如有个性化短信需求请使用发送个性短信协议超出以上规定的，SDK功能将被停用短信回执、账单请登录查询主体协议发送短信发送普通短信调用此方法，可单个或批量发送。注意：1、短信内容格式为：短信内容【签名】，要使用中文’【‘，签名可向客户经理咨询。发送地址http://host/send参数字段名称是否可空说明accName否用户名(乐信登录账号)accPwd否密码(乐信登录密码32位MD5加密后转大写，如123456加密完以后为：E10ADC3949BA59ABBE56E057F20F883E)aimcodes否手机号码(多个手机号码之间用英文半角“,”隔开,单次最多支持5000个号码)content否内容(内容长度请参照乐信()发送短信页面提示)，注意：在内容的最后需要加上在乐信()设置并通过审核的签名。如：公司定于1月25日召开今年的企业年会，请务必安排好时间。【动力思维】schTime是定时时间(格式为:如为空则为即时短信,如需定时时间格式为“yyyy-mm-ddhh24:mi:ss”。如果是GET提交，需要转码)dataType是返回的数据(类型支持:json/xml/string三种形式默认string)msgId是提交短信包的唯一id(15位以内数字)，推送短信回执时，会推送此值，用此值和手机号码来匹配短信的状态，如需要接受回执则必须提交此参数,单次提交只需要提交一个即可接口测试实例，可以在浏览器中直接输入测试（建议使用POST方式）/sdk/send?accName=***&accPwd=***&aimcodes=***&content=内容【签名】&dataType=string响应Json格式字段名称类型说明replyCode整型执行结果

1成功

0失败replyMsgText成功或失败原因具体信息succeedNum整型成功条数(当次提交成功的手机号码个数)failedNum整型失败条数(当次提交失败的手机号码个数)chargCount整型计费条数(当次提交计费的短信条数)deduction整型计费金额(当次提交的计费金额,单位:厘)balance整型余额(当次提交后的账户余额:单位:厘)示例:{"balance":"12882680","chargCount":61,"deduction":"3660","failedNum":0,"replyCode":1,"replyMsg":"发送成功!","succeedNum":61}响应xml格式字段名称类型说明replyCode整型执行结果

1成功

0失败replyMsg文本成功或失败原因具体信息succeedNum整型成功条数(当次提交成功的手机号码个数)failedNum整型失败条数(当次提交失败的手机号码个数)chargCount整型计费条数(当次提交计费的短信条数)deduction整型计费金额(当次提交的计费金额,单位:厘)balance整型余额(当次提交后的账户余额,单位:厘)示例:<?xmlversion="1.0"encoding="UTF-8"?><SendSmsReply><replyCode>1</replyCode><replyMsg>发送成功!</replyMsg><succeedNum>61</succeedNum><failedNum>0</failedNum><deduction>3660</deduction><balance>12028040</balance><chargCount>61</chargCount></SendSmsReply>响应string格式说明:多个响应参数之前以”;”隔开,格式为:成功或失败代码;成功或失败信息;成功条数;失败条数;计费条数;计费金额;余额;示例:1;发送成功!;61;0;61;3660;12024380;查询余额请求地址http://host/qryBalance参数字段名称是否可空说明accName否用户名(乐信登录账号)accPwd否密码(乐信登录密码32位MD5加密后转大写，如123456加密完以后为：E10ADC3949BA59ABBE56E057F20F883E)响应Json格式字段名称类型说明replyCode整型执行结果

1成功

0失败replyMsgText成功或失败原因具体信息balance整型余额,单位厘示例:{"balance":"4750","replyCode":1,"replyMsg":"查询成功"}响应xml格式字段名称类型说明replyCode整型执行结果

1成功

0失败replyMsg文本成功或失败原因具体信息balance整型余额,单位厘示例:<?xmlversion="1.0"encoding="UTF-8"?><QueryBalanceReply><replyCode>1</replyCode><replyMsg>查询成功</replyMsg><balance>4750</balance></QueryBalanceReply>响应string格式说明:多个响应参数之前以”;”隔开,格式为:成功或失败代码;成功或失败信息;余额(单位厘);示例:1;查询成功;4750短信报告查询请求地址http://host/qryReport参数字段名称是否可空说明accName否用户名(乐信登录账号)accPwd否密码(乐信登录密码32位MD5加密后转大写，如123456加密完以后为：E10ADC3949BA59ABBE56E057F20F883E)dataType是返回的数据(类型支持:json/xml/string三种形式默认string)响应Json格式字段名称类型说明replyCode整型执行结果1成功0失败replyMsgText成功或失败原因具体信息total整型本次查询的总条数reportDetails报告列表MSGID:发送时提交的msgId参数,AIMCODE:手机号SMS_STATUS:0或11表示成功0表示失败示例:{“replyCode”:”1”,”replyMsg”:"查询成功！","hasNext":"0","receiveCount":"0","replyInfos":[{MSGID:发送时提交的msgId参数,AIMCODE:手机号SMS_STATUS:0或11表示成功0表示失败}]}响应xml格式字段名称类型说明replyCode整型执行结果

1成功

0失败replyMsg文本成功或失败原因具体信息total整型本次查询的总条数reportDetails报告列表MSGID:发送时提交的msgId参数,AIMCODE:手机号SMS_STATUS:0或11表示成功0表示失败示例:<?xmlversion="1.0"encoding="UTF-8"?><QryReportDetailReply><replyCode>1</replyCode><replyMsg>查询成功！</replyMsg><total>0</total><reportDetails> <SendReport> <MSGID></MSGID> <AIMCODE></AIMCODE> <SMS_STATUS></SMS_STATUS> </SendReport></reportDetails></QryReportDetailReply>响应String格式说明:多个响应参数之前以”;”隔开,格式为:成功或失败代码;成功或失败信息;总条数#MSGID,AIMCODE,SMS_STATUS1;查询成功!;1#11;20;11;回复短信查询请求地址http://host/receiveSms参数字段名称是否可空说明accName否用户名(乐信登录账号)accPwd否密码(乐信登录密码32位MD5加密后转大写，如123456加密完以后为：E10ADC3949BA59ABBE56E057F20F883E)dataType是返回的数据(类型支持:json/xml/string三种形式默认string)响应Json格式字段名称类型说明replyCode整型执行结果1成功0失败replyMsgText成功或失败原因具体信息示例:{"replyCode":"1","replyMsg":"接受短信成功！","hasNext":"0","receiveCount":"0","replyInfos":[]}响应xml格式字段名称类型说明replyCode整型执行结果

1成功

0失败replyMsg文本成功或失败原因具体信息示例:<?xmlversion="1.0"encoding="UTF-8"?><ReceiveSmsReply><replyCode>1</replyCode><replyMsg>接受短信成功！</replyMsg><hasNext>0</hasNext><receiveCount>0</receiveCount><replyInfos/></ReceiveSmsReply>回执推送推送地址如需接收回执请联系客户经理绑定推送地址,要求地址可访问;推送参数及说明参数名称类型说明aimcodes字符串手机号，多个手机号以’,’隔开msgids字符串短信的唯一ID(15位以内数字)，多个ID以’,’隔开statuses字符串状态，多个状态以’,’隔开。1表示回执成功；0表示回执失败；acname字符串用户名type字符串参数类型，0表示回执信息推送返回响应合作方收到