API v1

开放查询 API

所有数据请求都通过本系统后端完成。请只使用你已获授权的数据源,不要在客户端暴露第三方地址、Cookie、Token 或签名。

认证

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx\nContent-Type: application/json\nIdempotency-Key: unique-request-key

查询接口

POST /api/v1/query/fans\nPOST /api/v1/query/play\nPOST /api/v1/query/qianchuan-auth\nPOST /api/v1/query/douplus-auth
{"items":["douyin_account_1","douyin_account_2"]}

统一返回

{"success":true,"request_id":"qry_xxx","query_type":"fans","total":2,"success_count":1,"failed_count":1,"duration_ms":1260,"results":[{"input":"douyin_account_1","success":true,"provider":"existing_http","data":{},"error_code":null,"message":"查询成功"}]}

追踪与额度

GET /api/v1/query/{request_id}\nGET /api/v1/account/usage

单次最多 10 条;错误码包括 INVALID_INPUTUNAUTHORIZEDRATE_LIMITEDPROVIDER_TIMEOUTPROVIDER_UNAVAILABLENOT_FOUND