API 文档

概述

Base URL

http://www.5la.cn/api/v1

方法

检测接口支持 GET 与 POST

格式

响应为 JSON；POST 时请求体为 JSON（Content-Type: application/json）

请求 ID

多数响应包含 request_id，便于排查

健康检查

GET /health

鉴权

检测接口使用 API Token，支持两种方式（Header 优先，与 query 同时存在时以 Header 为准）：

1. 请求头（推荐）

Authorization: Bearer sk_live_xxx

2. Query 参数（便于 GET）

?url=example.com&token=sk_live_xxx

Token 无效、已撤销或已过期时返回 401 INVALID_TOKEN。

安全提示：Query 中的 Token 可能进入访问日志、浏览器历史与 Referer。生产环境请优先使用请求头。

检测域名在微信侧的状态。GET 与 POST 均可；完整 URL 作 GET 参数时须 URL 编码。

GET 查询参数

• url（必填）待检测域名或完整 URL
• token（条件必填）未传 Authorization 头时提供 API Token

POST 请求体

{
  "url": "example.com"
}

域名 / URL 规则

• 支持纯域名或完整 URL；仅校验格式，不裁剪为 host
• 无协议时自动补默认协议（默认 http://），整链提交上游
• host 转小写并支持 IDN；path / query 保留原大小写；须为合法主机名且包含 .

cURL · GET

curl 'http://www.5la.cn/api/v1/detect/wechat?url=example.com&token=sk_live_xxx'

cURL · POST

curl -X POST http://www.5la.cn/api/v1/detect/wechat \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"example.com"}'

检测域名在抖音侧的状态。GET / POST、参数与鉴权方式同微信接口。

cURL · GET

curl 'http://www.5la.cn/api/v1/detect/douyin?url=example.com&token=sk_live_xxx'

cURL · 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"}'

成功响应

检测接口成功时返回扁平 JSON（无 data 包装）：

{
  "request_id": "1b353821c5ea2943cddc9316",
  "platform": "wechat",
  "url": "example.com",
  "checked_at": "2026-07-12T17:54:20+08:00",
  "status": "正常",
  "status_code": 200
}

错误码

失败时统一结构：

{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Token 无效、已撤销或已过期"
  },
  "request_id": "..."
}

限流与额度

每分钟限流按 用户 × 服务 × 分钟 计数（同一账号下所有 Token 共享）。默认 RPM（可在后台调整）：

• 免费版：10 次 / 分钟 / 服务，另有终身 50 次总调用额度（全服务合计）
• 专业版：60 次 / 分钟 / 服务
• 旗舰版：300 次 / 分钟 / 服务
• 企业版：1000 次 / 分钟 / 服务

成功或限流响应可能包含：

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset
• Retry-After（仅 429）
• X-Free-Quota-Limit / X-Free-Quota-Remaining（免费额度用尽时）

获取 Token

1. 在 控制台注册 或登录账号
2. 进入「Token 管理」，创建密钥（可设置名称与过期时间）
3. 妥善保存明文 Token（仅创建时展示一次）
4. 可选：在控制台「IP 白名单」配置允许调用的来源 IP；未添加时不限制来源，添加后仅列表内 IP 可调用检测接口