======================================================
         API 网关服务接口文档 (Plain Text)
======================================================

该服务代理对 Cloudflare D1, R2, 和 Queue 的访问。

------------------------------------------------------
1. 认证 (Authorization)
------------------------------------------------------
所有请求都必须携带 Bearer Token。

Header: Authorization: Bearer <CLOUDFLARE_CUSTOM_ACCESS_TOKEN>

------------------------------------------------------
2. R2 对象存储代理
------------------------------------------------------
基础路径: /v0/r2-binding/:r2-binding/object-key/:object-key

[PUT] 存入对象
用途: 上传文件内容。
Body (JSON):
{
  "payload": {
    "contentType": "string (可选, 如 image/png)",
    "binaryData": "string (必填, Base64解码后的二进制字符串)"
  }
}
响应: 201 Created，返回对象元数据。

[GET] 获取对象
用途: 检索指定对象的内容。
响应: 200 OK，返回包含对象数据的 JSON 结构。

[DELETE] 删除对象
用途: 删除指定对象。
响应: 200 OK。

------------------------------------------------------
3. D1 数据库代理
------------------------------------------------------
端点: POST /v0/d1-binding/:d1-binding/query
用途: 执行 D1 SQL 查询 (单次或批量)。
Body (JSON): (单个查询或查询数组)
{
  "sql": "string",
  "params": "any[] (可选, 绑定参数)"
}
响应: 200 OK，返回 D1 Result 数组。

------------------------------------------------------
4. Queue 消息队列代理
------------------------------------------------------

[POST] 提交消息 (Submit)
端点: /v0/queue-binding/:queue-binding/submit
用途: 发送任务消息到队列，并在 DO 中标记状态为 PENDING。
Body (JSON):
{
  "taskId": "string (必填, 唯一任务ID)",
  "payload": "any (可选, 任务数据)"
}
响应: 200 OK，返回任务已入队的消息。

[GET] 查询状态 (Status)
端点: /v0/queue-binding/:queue-binding/status?taskId=...
用途: 查询 Durable Object 中的任务状态。
响应: 200 OK，返回 {status: "PENDING" | "COMPLETED" | ...}。

------------------------------------------------------
5. 响应结构
------------------------------------------------------
成功: { "success": true, "error": null, "message": "<数据>" }
失败: { "success": false, "error": { "code": 1xxx, "message": "描述" }, "message": null }