文档

开发者文档

统一的 RESTful 接口, 一个 API Key 调用全网平台。

快速开始

1
注册并登录
创建账户后进入控制台。
2
创建 API 密钥
在「API 密钥」页生成密钥, 复制保存(仅显示一次)。
3
充值额度
在「钱包」页充值, 充值到账后即可调用。
4
发起请求
使用密钥调用任意接口, 按次扣费, 失败自动退款。

认证方式

所有请求需在 Header 中携带 API Key:

bash

Authorization: Bearer ak_your_api_key

接口路径格式: GET /api/v1/{平台}/{接口路径}?{参数}

调用示例

以获取抖音作品详情为例:

bash

curl -X GET 'https://api.yoursite.com/api/v1/douyin/web/fetch_one_video?aweme_id=7123456789' \
  -H 'Authorization: Bearer ak_your_api_key'

响应(标准化 JSON):

bash

{
  "data": {
    "desc": "作品描述",
    "statistics": { "play_count": 12345, "digg_count": 678 }
  }
}

Python

import requests
resp = requests.get(
    "https://api.yoursite.com/api/v1/douyin/web/fetch_one_video",
    params={"aweme_id": "7123456789"},
    headers={"Authorization": "Bearer ak_your_api_key"},
)
print(resp.json())

错误码

200成功

401未授权 — API Key 缺失或无效

402余额不足 — 请充值后再调用

403禁止访问 — Key 已禁用 / IP 不在白名单

404接口不存在或已下线

429请求过频 — 触发限流, 请降低调用频率

502上游连接失败 — 服务端将自动退款

503上游未配置 — 联系管理员

注: 上游返回 4xx/5xx 时, 系统会自动退还本次预扣额度, 不计费。

API 平台目录