网站状态接口文档说明
⚠️ 网站状态检测用途:检测指定域名的在线状态、响应时间、HTTP状态码等信息,支持自定义超时时间与重定向跟随;适用于网站监控、故障排查、可用性验证等场景,url参数无需加http/https协议头。
接口地址:
https://api.qyuan.asia/api/wzzt
请求方式:
GET(参数拼接便捷,支持POST兼容)
请求类型:
无特殊要求(浏览器/代码调用均可)
返回格式:
JSON(默认,含在线状态、状态码、响应时间等)
接口用途:
检测网站域名的可用性与响应信息,适用于网站监控、故障排查、第三方服务可用性验证等场景
Header 参数
<<<<<<<<<<<<<<<<<<<| 参数名称 |
<<<<<<<<<<<<<<<<<<<参数类型 |
<<<<<<<<<<<<<<<<<<<示例值 |
<<<<<<<<<<<<<<<<<<<参数说明 |
| 无 |
— |
— |
本接口无需 Header 参数,直接调用即可 |
请求参数(Query / Body)
<<<<<<<<<<<<<<<<<<<| 参数名称 |
<<<<<<<<<<<<<<<<<<<是否必填 |
<<<<<<<<<<<<<<<<<<<参数类型 |
<<<<<<<<<<<<<<<<<<<示例值 |
<<<<<<<<<<<<<<<<<<<参数说明 |
| url |
必填 |
string |
baidu.com / api.qyuan.asia |
待检测的网站域名,无需加http/https协议头,支持二级/三级域名 |
| timeout |
可选 |
number |
15 / 10 |
检测超时时间(单位:秒),默认15秒,取值范围1-30秒,超过时间判定为“超时不可用” |
| follow |
可选 |
number |
1 / 0 |
是否跟随301/302重定向:1=跟随(返回最终跳转后的状态),0=不跟随(返回原始重定向状态码),默认1 |
请求与返回示例
// 1. 请求示例(检测百度,跟随重定向,15秒超时)
https://api.qyuan.asia/api/wzzt?url=baidu.com&timeout=15&follow=1
// 2. 返回示例(网站在线)
{
"code": 200,
"msg": "检测成功,网站在线",
"data": {
"url": "baidu.com",
"isOnline": true, // 是否在线
"httpCode": 200, // HTTP状态码
"responseTime": 320, // 响应时间(毫秒)
"timeout": 15, // 设定的超时时间(秒)
"followRedirect": true, // 是否跟随重定向
"finalUrl": "https://www.baidu.com/" // 最终访问地址(跟随重定向时返回)
}
}
// 3. 返回示例(网站超时/不可用)
{
"code": 200,
"msg": "检测完成,网站不可用",
"data": {
"url": "test.example.com",
"isOnline": false,
"reason": "请求超时", // 不可用原因(超时/域名无效/连接失败等)
"timeout": 10
}
}