站点可用性检测

GET 需密钥

检测指定站点域名当前是否可以正常访问（目标站点有没有挂掉）。网关向目标站点发起真实 HTTPS/HTTP 探测请求，返回 up/down 结论、HTTP 状态码、解析出的 IP 与耗时，站点不可访问时给出原因分类。

调用地址

https://api.shurans.cn/api/site-status

调用方式

GET

# 请求头携带密钥
Authorization: Bearer <你的密钥>

请求参数

参数	必填	示例	说明
domain	必填	example.com	待检测的站点域名（裸域名）：不要带 http:// 或 https:// 前缀，不支持 IP 地址、端口与路径，中文域名请先转 punycode
timeout	可选	5	单次探测超时秒数，1–10，默认 5
scheme	可选	auto	探测协议：auto（默认，先 https，TLS / 连接失败自动回退 http）\| https \| http

响应示例

{
    "code": 200,
    "message": "ok",
    "data": {
        "domain": "example.com",
        "status": "up",
        "scheme": "https",
        "http_code": 200,
        "ip": "93.184.216.34",
        "latency_ms": 187,
        "error": null,
        "checked_at": "2026-10-16 14:30:00"
    },
    "meta": { "request_id": "7214361835712ec46e74081384fc82be" }
}

响应字段说明

字段	说明
code	业务状态码，成功恒为 200
message	状态说明，成功恒为 ok
data.domain	检测的域名（自动转为小写）
data.status	检测结果：up 可正常访问 \| down 不可访问
data.scheme	实际使用的探测协议（https \| http；auto 模式回退后为实际尝试的协议）
data.http_code	站点返回的 HTTP 状态码；未收到 HTTP 响应时为 0
data.ip	域名解析到的 IP 地址；解析 / 连接未成功时为 null
data.latency_ms	探测总耗时（毫秒）；站点不可访问时为 null
data.error	不可访问原因：dns_failure 域名解析失败 \| connect_failure 连接失败 \| timeout 超时 \| tls_failure TLS / 证书异常 \| http_error HTTP 4xx/5xx；可访问时为 null
data.checked_at	本次检测时间
meta.request_id	本次请求的追踪 ID（32 位十六进制），同时随 X-Request-Id 响应头返回