HI8D.COM国际云通讯HTTP接口（1.0）.doc

HI8D.COM国际云通讯HTTP接口（1.0） 下行接口 我方平台提供HTTP POST接口方式，供各合作方调用下行短信，POST接口相关参数如下： 下行接口地址：/servlet/gateway.php 传送参数 参数 必须 说明 account * 用户帐号 passwd * 用户密码(必须为MD5加密 转换大写) sender * 发送者号码，可选，需要具体通道支持（提交到服务器请要加载国家区位码，否则短信无法发出） mb * 手机号码，多个号码之间以“,”（半角逗号）分隔； content * 短信内容。UTF-8编码格式。 返回参数格式（json） 参数 说明 status 状态码：0失败，其他数值表示成功 guid 短信唯一编码 (多条根据提交短信的条数) mb 发送短信手机号码 (多条根据提交短信的条数) msg 返回描述 服务提供方：我方 服务调用方：各合作方 PHP请求例子： Function http($url, $method, $postfields = NULL) { $ci = curl_init(); curl_setopt($ci, CURLOPT_URL, $url); curl_setopt($ci, CURLOPT_CONNECTTIMEOUT, 30); // 连接超时 curl_setopt($ci, CURLOPT_TIMEOUT, 30); // 执行超时 curl_setopt($ci, CURLOPT_RETURNTRANSFER, true); // 文件流的形式返回，而不是直接输出 curl_setopt($ci, CURLOPT_ENCODING, gzip); curl_setopt($ci, CURLOPT_HEADER, FALSE); if (POST == $method) { curl_setopt($ci, CURLOPT_POST, true); // post } if (!empty($postfields)) { curl_setopt($ci, CURLOPT_POSTFIELDS, $postfields); // post数据 可为数组、连接字串 } $response = curl_exec($ci); curl_close($ci); return $response; } 单条提交 http(“/servlet/gateway.php”,”POST”,{“account”:”10010”,”sender”:”111111”,”passwd”:”密码”,”mb”:”发送号码”,”content”:”这是一条短信”}) 多条提交 http(“/servlet/gateway.php”,”POST”,{“account”:”10010”,”sender”:”111111”,”passwd”:”密码”,”mb”:”123456789，123456789”,”content”:”这是一条短信”}) 提交成功后，界面返回 成功{status:1,msg:\u7528\u6237\u540d\u6216\u8005\u5bc6\u7801\u9519\u8bef，“guid”：“1234567890”,”mb”:”8618611287980”} 多条提交 {status:1,msg:\u7528\u6237\u540d\u6216\u8005\u5bc6\u7801\u9519\u8bef，“guid”：“1234567890,1234567890”,”mb”:”8618611287980,8618611287980”} 失败{status:0,msg:\u7528\u6237\u540d\u6216\u8005\u5bc6\u7801\u9519\u8bef} 状态报告推送接口（采用POST方式） 请合作方，在系统后台添加接收POST信息的网址路径。 将会收到 成功： {status:1,msg:\u53c2\u6570\u9519\u8bef,”guid””sms”:”0”,”mb”:”8618611287980”} 失败 {status:0,msg:\u53c2\u6570\u9519\u8bef,”guid””,”sms”:”0”,”mb”:”8618611287980”} 参数说明： status：请求状态 （1成功；0失败或者其他失败数值） msg：提示内容。 guid：唯一标识 s