面向第三方开发者与渠道合作伙伴的开放接口。覆盖话费充值、CPS 推广、香港业务、驿站福利、上门回收、宽带办理、快递寄件与淘客转链等业务能力,基于 HTTPS 与 Bearer Token 安全认证,开箱即用。
所有接口遵循统一规范:使用 HTTPS 协议、JSON 数据格式与 Bearer Token 认证,请仔细阅读以下约定后再进行联调。
JSON(Content-Type: application/json)UTF-8/api/ 开头POST / GET(见各接口说明)Authorization: Bearer <Token>401 错误{
"code": 200, // 业务状态码,200 表示成功
"message": "success", // 提示信息
"data": { ... } // 业务数据,可为对象或数组
}订单号为准进行后续查询与对账// 注释 的仅用于说明,请求时请勿携带共 0 个接口,按业务模块分组。点击接口卡片可展开查看请求参数与响应示例。所有接口均需在请求头携带 Authorization: Bearer <Token>。
以「提交充值订单」接口为例,演示携带 Token 的 POST 请求调用方式。其他接口调用方式一致,仅替换路径与参数即可。
<?php $baseUrl = ''; $token = '你的 Bearer Token'; $path = '/api/recharge/submitOrder'; $data = [ 'phone' => '13800138000', 'type' => 'slow', // slow 慢充 / fast 快充 / small 溢价 'face_value' => 50, 'downstream_order_no' => 'MY20260707001', ]; $ch = curl_init($baseUrl . $path); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'Authorization: Bearer ' . $token, ], CURLOPT_POSTFIELDS => json_encode($data, JSON_UNESCAPED_UNICODE), ]); $result = json_decode(curl_exec($ch), true); curl_close($ch); if ($result['code'] === 200) { // 下单成功,处理订单号等数据 print_r($result['data']); } else { // 业务失败,查看 message echo $result['message']; }
业务是否成功统一以响应体中的 code 字段判断,HTTP 状态码仅代表网络与协议层面是否成功。
请求处理成功,业务数据位于 data 字段。
参数缺失、格式不正确或业务校验失败(如余额不足),详见 message 提示。
请求头缺少 Authorization 或 Token 无效、已过期。
当前账号无该接口的访问权限,或被系统风控拦截。
请求的接口路径不存在或未开放,请核对接口地址。
服务器处理异常,请稍后重试;如持续出现请联系技术支持。