接口文档
Base URL：https://file.yotoo.vip
1. 鉴权
所有业务接口都需要 API Key，直接拼在 URL 的 key 参数上；同时兼容 Authorization 请求头。
推荐：Query 传参
GET https://file.yotoo.vip/v1/douyin/parse?key=ak_xxxxxxxx&url=https://v.douyin.com/xxx
兼容：Header 传参
Authorization: Bearer ak_xxxxxxxx
2. 同步调用
网关最多等待 10 秒；超时返回 HTTP 202 与 task_id，可改用异步查询。
curl
curl "https://file.yotoo.vip/v1/douyin/parse?key=ak_xxxxxxxx&url=https://v.douyin.com/xxx"
3. 异步任务
| 接口 | 方法 | 说明 |
|---|---|---|
| /v1/task/submit | POST | 提交任务，返回 task_id |
| /v1/task/result | GET | 查询结果，支持 wait 长轮询 |
| /v1/task/cancel | POST | 取消排队中的任务并回滚预扣 |
提交任务
curl -X POST "https://file.yotoo.vip/v1/task/submit?key=ak_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"function":"douyin.parse","params":{"url":"https://v.douyin.com/xxx"}}'
4. 功能端点
| 功能 | Code | 路径 | 单价 |
|---|---|---|---|
| 抖音视频解析 | douyin.parse | /v1/douyin/parse | ¥0.0100 |
5. 错误码
| code | 含义 |
|---|---|
| 0 | 成功 |
| 1001 | API Key 无效或已禁用 |
| 1002 | 套餐已过期 |
| 1003 | 余额不足 |
| 1004 | 当日额度已用完 |
| 1005 | QPS 超限（默认不返回：超限请求自动转队列排队，返回 202 + task_id） |
| 1006 | 当日调用次数超过上限 |
| 1007 | 套餐总额度已用完 |
| 1008 | 队列已满 |
| 2001 | 参数错误 |
| 2002 | 功能不存在或已下线 |
| 2003 | 任务不存在或无权访问 |
| 3001 | 服务暂时不可用（已回滚） |
| 3002 | 请求超时（已回滚） |
| 5000 | 服务器内部错误 |