CHECK
查询是否为黑名单
GET /api/v1/check?q=@username 可查询 Telegram 用户名或数字 ID。查询 IP 时请使用 POST,避免 IP 被写入 URL 或代理访问日志。
curl "https://your-domain.example/api/v1/check?q=@username"
curl -X POST https://your-domain.example/api/v1/check \
-H "Content-Type: application/json" \
-d '{"q":"203.0.113.10"}'
命中时的关键字段:
{
"blacklisted": true,
"match_count": 1,
"matches": [{
"id": 12,
"telegram_id": "123456789",
"telegram_username": "@example",
"incident_count": 2,
"detail_url": "/api/v1/subjects/12"
}]
}