微信 URL 封禁检测 API

实时检测一个链接在微信内是否会被风控拦截 / 封禁。适合需要自动化集成的客户。 控制台自助开通 Key：/console

1. 鉴权

所有业务接口用 HTTP Header 携带 API Key：

Authorization: Bearer <你的 API_KEY>

Key 在 API 控制台 签发，形如 sk_xxxxxxxx。请妥善保管，泄露后可在控制台停用并重发。

2. 实时检测

POST https://check.haoyunlaile.top/api/detect

请求体

{ "url": "https://example.com/landing" }

成功响应 200

{
  "ok": true,
  "status": "FORBIDDEN",
  "errType": "adult_content",
  "errCode": 0,
  "checkedAt": 1780000000000
}

status 取值

status	含义
NORMAL	正常，微信内可直接打开
RISK_WARN	风险提示，微信会弹确认页（点确认仍可访问）
FORBIDDEN	已被封禁，微信禁止访问
UNKNOWN	未能判定（少见，建议重试）

常见 errType

errType	含义
adult_content	色情低俗内容
webpage_security_risk	网页存在安全风险
content_misuse_risk	可能被恶意利用生成违规内容
network_security_unverified	无法确认网络安全性
non_wechat_official_page	非微信官方网页
browser_required	需复制到浏览器访问，风险级别低于封禁
blocked	微信风控拦截，暂未细分

错误响应

HTTP	reason	说明
400	invalid_url	url 缺失或非 http(s)
401	invalid_api_key	Key 缺失/无效/已停用
429	rate_limited	超出频率限制，稍后重试
503	no_device_online / timeout	检测节点暂不可用（非"链接被封"），建议重试

注意：503 表示"检测服务暂时不可用"，不要据此判断链接被封；只有 200 + status=FORBIDDEN 才是封禁。

调用示例

curl -X POST https://check.haoyunlaile.top/api/detect \
  -H "Authorization: Bearer sk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/landing"}'

3. 频率与计量

检测会消耗真实校验额度，服务端做了全局排队节流，单次请求通常秒级返回（最长约 20s）。 请勿高并发刷量；如需更高额度请联系客服。每次成功检测计 1 次用量，可在控制台查看本月用量。

4. 无技术能力？用自动监控

不想自己接 API，可直接把链接交给我们 7×24 自动巡检，一旦被微信封禁即时通知到你的服务群。 速查体验：check.haoyunlaile.top · 开通监控请联系客服。