HTTP短信接口文档.docx

:2013-02-18接口域名:、 工作方式 2三、 响应格式 2四、 短信发送流程 2五、 短信发送任务接口 3六、 提交号码包 5七、 取消发送任务 7工作方式双方通过HTTP方式交互数据,第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。 另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为XML),安全验证使用32位认证密钥的方式。字符编码服务器接收数据UTF-8编码字符,请求响应返回内容是UTF-8编码。响应格式所为响应即每次向服务器提交请求后返回值响应值格式为XML:<xml name="xxx" result="0"/>Name为提交的接口名Result 为返回的状态码短信发送流程先调用添加短信群发任务接口,添加。发送任务成功完成后可以分包批量提交要发送的号码包。在号码包未全部提交完成时可以调用取消任务接口取消发送任务。短信发送任务接口接口参数说明:参数名参数字段参数说明ac用户账号发送短信的帐号(员工编号@企业编号)authkey认证密钥32位认证密钥,每个企业由管理在软件中获取和修改type定时类型可选项,默认为立即发送(0)0 //立即发送1 //只发一次2 //每天一次3 //每周一次4 //周六周日5 //每周工作日6 //每月一次7 //每年一次t发送时间1970年1月1日到现在的秒数ASP:newDate().getTime()/1000C++:time(NULL)PHP:time(void)JAVA:newDate().getTime()/1000tnum总号码数指定要发送的号码总数cgid通道组编号使用的通道组编号,由帐号决定可用的通道组c短信内容发送内容需要进行URL字符标准化转码。{URL字符编码说明:返回字符串,此字符串中除了-(%)后跟两位十六进制数,空格则编码为加号(+)}ASP:("短信内容")PHP:urlencode("短信内容")JAVA:.("短信内容")例:?action=startMission&ac=******@50000888&authkey=87B01469201D6557C2685137EB3B5DEC&cgid=80&tnum=1&c=%E6%B5%8B%E8%AF%95成功时返回响应:<xmlname="startMission"result="1"><Itemcid="50000888"sid="1001"mid="1018"total="1"fee=""remain=""/></xml>失败时返回响应:<xmlname="startMission"result="-1"/>返回参数说明:参数名参数字段参数说明cid企业编号发送短信的企业编号sid员工编号发送短信的员工编号mid任务编号返回的任务编号total短信条数任务需要的短信条数fee单价任务中每条短信的价格remain余额发送任务后企业的帐户余额返回状态码说明:参数名