Warning: include(/www/wwwroot/124.223.0.118/_api_doc_data.php): failed to open stream: No such file or directory in /www/wwwroot/124.223.0.118/api-doc.php on line 18

Warning: include(): Failed opening '/www/wwwroot/124.223.0.118/_api_doc_data.php' for inclusion (include_path='.:') in /www/wwwroot/124.223.0.118/api-doc.php on line 18

Warning: Invalid argument supplied for foreach() in /www/wwwroot/124.223.0.118/api-doc.php on line 46
开放平台 API 文档 - 造梦开放平台 | 开发者接入指南
造梦
首页
账户注册
开发者接入指南 · Developer Guide

造梦开放平台 API 文档

面向第三方开发者与渠道合作伙伴的开放接口。覆盖话费充值、CPS 推广、香港业务、驿站福利、上门回收、宽带办理、快递寄件与淘客转链等业务能力,基于 HTTPS 与 Bearer Token 安全认证,开箱即用。

📡 0 个标准接口 🧩
Warning: count(): Parameter must be an array or an object that implements Countable in /www/wwwroot/124.223.0.118/api-doc.php on line 265
0 大业务模块
🔐 Bearer Token 鉴权 ⚡ JSON 数据交换
基础域名
接入说明

接口通用规范

所有接口遵循统一规范:使用 HTTPS 协议、JSON 数据格式与 Bearer Token 认证,请仔细阅读以下约定后再进行联调。

🚀 基础信息 必读

  • 请求域名:
  • 数据格式:JSON(Content-Type: application/json)
  • 字符编码:UTF-8
  • 接口路径:统一以 /api/ 开头
  • 请求方式:POST / GET(见各接口说明)

🔐 认证方式 必读

  • 所有接口均需在请求头携带
  • 请求头:Authorization: Bearer <Token>
  • Token 由平台后台发放,请妥善保管,切勿泄露
  • 非法或缺失 Token 将返回 401 错误
  • 如遇 Token 失效,请联系平台管理员重新签发

📦 公共响应结构

{
    "code": 200,        // 业务状态码,200 表示成功
    "message": "success", // 提示信息
    "data": { ... }     // 业务数据,可为对象或数组
}

⚠️ 注意事项

  • 部分接口有频率限制,请勿恶意 / 高频请求,否则可能进入黑名单
  • 部分接口做了数据缓存(如面额查询),请勿频繁重复请求
  • 下单类接口请以返回的订单号为准进行后续查询与对账
  • 参数中带 // 注释 的仅用于说明,请求时请勿携带
接口文档

业务接口详情

共 0 个接口,按业务模块分组。点击接口卡片可展开查看请求参数与响应示例。所有接口均需在请求头携带 Authorization: Bearer <Token>。


Warning: Invalid argument supplied for foreach() in /www/wwwroot/124.223.0.118/api-doc.php on line 356
代码示例

快速开始:PHP 调用示例

以「提交充值订单」接口为例,演示携带 Token 的 POST 请求调用方式。其他接口调用方式一致,仅替换路径与参数即可。

PHP 示例(curl)

<?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 状态码仅代表网络与协议层面是否成功。

200

成功

请求处理成功,业务数据位于 data 字段。

400

参数错误 / 业务失败

参数缺失、格式不正确或业务校验失败(如余额不足),详见 message 提示。

401

未认证

请求头缺少 Authorization 或 Token 无效、已过期。

403

无权限

当前账号无该接口的访问权限,或被系统风控拦截。

404

接口不存在

请求的接口路径不存在或未开放,请核对接口地址。

500

服务器内部错误

服务器处理异常,请稍后重试;如持续出现请联系技术支持。

开始你的 API 接入

立即申请开发者权限,技术文档与示例代码全量开放。如有疑问,欢迎联系平台客服获取一对一技术支持。

申请开发者权限