检查URL的可访问性状态
检查URL的可访问性状态
GET /network/urlstatus - 检查URL的可访问性状态
你的网站或API还好吗？用这个接口给它做个快速“体检”吧。
功能概述
提供一个URL，我们会向它发起一个请求，并返回其HTTP响应状态码。这是一种简单而有效的服务可用性监控方法。
网络
检查URL的可访问性状态
0次调用
1 积分/次
你的网站或API还好吗？用这个接口给它做个快速“体检”吧。
GET
uapis.cn
/api/v1/network/urlstatus
查询参数
1
url
string
required
你需要检查其可访问性状态的完整URL。
功能概述
提供一个URL，我们会向它发起一个请求，并返回其HTTP响应状态码。这是一种简单而有效的服务可用性监控方法。
查询参数
urlstring必填
你需要检查其可访问性状态的完整URL。
响应
200 / 请求成功
检查完成！根据目标URL的可达性返回不同结果。
格式 1可达响应
当目标 URL 可访问时，status 为目标返回的 HTTP 状态码（如 200）。
JSON
{
// 目标URL实际返回的HTTP状态码。
"status": 200,
"url": "https://www.google.com"
}格式 2不可达响应
当目标 URL 不可达或请求失败（如 DNS 失败、超时、连接失败）时，status 为 0。
JSON
{
// 目标不可达或请求失败时固定为 0。
"status": 0,
"url": "https://example.invalid"
}400 / 错误的请求
请求参数无效。请检查 url 参数是否提供且格式正确。
JSON
{
"code": "INVALID_ARGUMENT",
"details": {},
"message": "Missing or invalid 'url' parameter."
}502 / 网关错误
请求URL失败（例如，DNS解析失败、连接超时）
JSON
{
"code": "REQUEST_FAILED",
"details": {},
"message": "Failed to request the URL. It might be down or unreachable."
}