发送状态报告推送接口（采用post方式）.doc

HI8D.COM国际云通讯HTTP接口 API接口 我方平台提供HTTP POST接口方式，供各合作方调用下行短信，POST接口相关参数如下： API接口地址：/servlet/gateway.php 短 信 提 交 参 数 参数 要求 说明 account 必须 用户帐号 passwd 必须 用户密码(必须为MD5加密 转换大写) sender 可选 发送者号码，需要具体通道支持 mb 必须 手机号码，多个号码之间以“,”（半角逗号）分隔；提交号码要加载国家区位码，否则短信无法发出 content 必须 短信内容。UTF-8编码格式。 返回参数格式（json） 参数 说明 status 短信提交状态码：0成功，其他数值表示失败，失败原因请参考msg参数 guid 短信唯一编码 (多条提交短信对应多条编码) mb 发送短信手机号码 msg 返回参数描述： 参数错误 用户名或者密码错误 提交的手机号码不正确 发送内容不能为空 账户余额不足 发送成功 提交成功 ip授权错误 短信不存在; 服务提供方：我方 服务调用方：各合作方 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”:”密码（MD5加密）”,”mb”:”8613910511127”,”content”:”短信内容”}) 多条提交 http(“/servlet/gateway.php”,”POST”,{“account”:”10010”,”sender”:”111111”,”passwd”:”密码（MD5加密）”,”mb”:”8613910511127,85268520007”,”content”:”短信内容”}) 提交成功后，返回反馈信息示例： 单条提交返回提交状态 {status:0,msg:\u7528\u6237\u540d\u6216\u8005\u5bc6\u7801\u9519\u8bef，“guid”：“1234567890”,”mb”:”8613910511127”} 多条提交返回提交状态 {status:0,msg:\u7528\u6237\u540d\u6216\u8005\u5bc6\u7801\u9519\u8bef，“guid”：“1234567890,1234567891”,”mb”:”8613910511127,85268520007”} 提交失后返回反馈信息示例 {status:1,msg:\u7528\u6237\u540d\u6216\u8005\u5bc6\u7801\u9519\u8bef} 发送状态报告推送接口（采用POST方式） 请合作方，联系我司客服人员，在系统后台添加接收POST信息的网址路径。 参 数 说 明 status： 短信提交状态码：0成功，1其