统一 API 响应格式
与微信检测共用字段约定：request_id、platform、url、checked_at、status、status_code，降低双平台对接成本。
核心能力
围绕鉴权、检测、限流与可观测性设计，便于将抖音域名检测嵌入现有业务系统。
稳定的域名状态识别
将上游结果映射为 正常/拦截/未知 与 status_code 200/403/520，业务侧可按码做放行、拦截或重试策略。
会员级别限流控制
按用户与服务维度统计 RPM，响应头提供 Limit / Remaining / Reset；被限流时返回 Retry-After。
控制台集中管理 Token
支持多密钥、多环境隔离，创建时明文仅展示一次，可设置过期并随时撤销。
调用日志可观测
在控制台查看检测域名、返回状态与耗时，结合 request_id 快速定位问题。
可选 IP 白名单
为检测接口配置服务器出口 IP 白名单，增强账号安全性，最多可配置 20 个地址。
检测结果说明
成功时 HTTP 200，响应包含中文 status
与数字 status_code。结果反映请求时的上游状态，不代表域名状态永久不变。
200
正常
当前检测正常，可继续使用，并按业务需要定期复检。status_code=200。
403
拦截
检测到域名被限制或存在安全风险，建议暂停投放或跳转并排查域名。status_code=403。
520
未知
上游返回了未明确映射的状态，不应视为正常，建议稍后重试或人工复核。status_code=520。
接口一览
请求与响应均为 JSON。检测接口通过 Bearer Token 鉴权；url
支持纯域名或完整 URL，无协议时自动补默认协议后整链送检。
- 接口
GET|POST /api/v1/detect/douyin- 鉴权
Authorization: Bearer sk_live_xxx- 请求体
{"url":"example.com"}- 成功字段
- request_id、platform、url、checked_at、status、status_code
请求示例
# GET
curl 'http://www.5la.cn/api/v1/detect/douyin?url=example.com&token=sk_live_xxx'
# POST
curl -X POST http://www.5la.cn/api/v1/detect/douyin \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"url":"example.com"}'适用场景
将抖音域名检测嵌入投放与运营关键节点，用 status_code 驱动放行、告警或人工复核。
短视频与信息流投放
投放素材上线前校验落地页与跳转域名，降低因域名受限导致的投放失效。
活动与拉新链路
活动页、邀请页与下载引导页定期检测，及时替换异常域名。
分享与站外导流
在生成分享或导流链接前确认域名状态，改善用户打开体验。
统一中台双平台巡检
与微信检测共用鉴权与日志，一套调度同时覆盖双平台域名巡检任务。
常见问题
抖音与微信检测接口有何区别？
路径分别为 /api/v1/detect/douyin 与 /api/v1/detect/wechat，鉴权方式、请求体 url 规则与成功响应字段保持一致，platform 字段会标识具体平台。
如何开始调用抖音域名检测？
注册并登录控制台，创建 API Token 后，可用 GET /api/v1/detect/douyin?url=example.com&token=sk_live_xxx，或 POST 提交 JSON：{"url":"example.com"} 并在请求头携带 Bearer Token。
status_code 返回 520（未知）应如何处理？
520 表示上游状态未能明确映射，不应当作正常（200）。建议指数退避重试，必要时结合 request_id 联系支持或人工复核。
是否支持 IP 白名单？
支持。未配置任何 IP 时不限制来源；配置后仅白名单内 IPv4/IPv6 可调用，按精确匹配，不支持 CIDR。
