# Media Parser 开发者 API 文档本文档面向**申请并使用 API Token** 的第三方开发者，说明如何通过 HTTP API 集成媒体解析能力。 **线上地址**：`https://open.cweto.cn` **本地调试**：`http://127.0.0.1:8052` --- ## 接入概览 ``` 注册账号 → 验证邮箱 → 申请 API Token → 携带 Token 调用业务接口 ``` | 阶段 | 说明 | |------|------| | 获取 Token | 在 [首页](https://open.cweto.cn/)「账户 → 开发者 API」申请，或通过下方账户接口程序化申请 | | 调用接口 | 所有业务请求在 Header 携带 `Authorization: Bearer mp_xxx` | | 计费 | 按自然月累计调用 `/api/parse` 次数阶梯计价，详见 [API 价格](#api-价格) | **业务接口（需 API Token）** | 接口 | 方法 | 说明 | |------|------|------| | `/api/parse` | POST | 解析分享链接，返回视频/图集直链 | | `/api/download` | GET | 代理下载媒体文件 | | `/api/image` | GET | 代理预览图片/视频流 | **健康检查（无需鉴权）**：`GET /health` → `{"status":"ok"}` --- ## 第一步：获取 API Token ### 方式一：网站申请（推荐） 1. 打开 [https://open.cweto.cn](https://open.cweto.cn) 注册并登录 2. 查收邮件，点击链接完成邮箱验证 3. 进入「账户 → 开发者 API」，点击「申请 API Token」 4. **立即复制** Token（`mp_` 开头，**仅显示一次**） ### 方式二：API 申请 Token 创建接口需要临时使用登录 JWT；拿到 `mp_` Token 后，后续业务调用**只需 API Token**。 ```bash # 1. 注册 curl -s -X POST https://open.cweto.cn/api/auth/register \ -H "Content-Type: application/json" \ -d '{"email":"dev@example.com","password":"yourpassword"}' # 2. 验证邮箱（点击邮件链接） # GET https://open.cweto.cn/api/auth/verify?token= # 3. 登录，获取 JWT（仅用于管理 Token） curl -s -X POST https://open.cweto.cn/api/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"dev@example.com","password":"yourpassword"}' # 4. 申请 API Token curl -s -X POST https://open.cweto.cn/api/auth/token \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{"name":"我的应用"}' # 响应 data.token 即为 mp_xxx，请妥善保存 ``` ### 第二步：开始调用 ```bash curl -s -X POST https://open.cweto.cn/api/parse \ -H "Content-Type: application/json" \ -H "Authorization: Bearer mp_xxxxxxxx..." \ -d '{"text":"https://www.bilibili.com/video/BV1xx411c7mD"}' ``` --- ## API Token 鉴权在请求头携带 API Token： ```http Authorization: Bearer mp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` | 项目 | 说明 | |------|------| | 格式 | 以 `mp_` 开头 | | 适用范围 | `/api/parse`、`/api/download`、`/api/image` | | 创建次数 | 每账号默认最多 **3** 个有效 Token | | 泄露处理 | 在网站「Token 列表」撤销后重新申请 | > **安全提示**：API Token 等同于密码，仅用于服务端调用。不要写入前端公开代码、不要提交到 Git。优先使用 `Authorization` 请求头；仅在 `