支持网址多轮(10 次)网络测速(DNS / 连接 / TTFB / 总耗时),并查询站点完整信息(IP / 地域 / CDN/HTTPS 证书 / 响应状态),输出测速统计数据(均值 / 中位数 / 方差等)
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| url | url | 是 | 需要进行多ping的url,注:需要携带协议头,如:http://xiaoapi.cn/ | https://baidu.com |
| n | integer | 否 | 需要进行的ping次数,仅可为:1-10次,默认ping1次 | 1 |
[
{
"name": "url",
"type": "url",
"required": true,
"description": "需要进行多ping的url,注:需要携带协议头,如:http://xiaoapi.cn/",
"example": "https://baidu.com"
},
{
"name": "n",
"type": "integer",
"required": false,
"description": "需要进行的ping次数,仅可为:1-10次,默认ping1次",
"example": "1"
}
]
{"openapi":"3.1.1","info":{"title":"网站Ping","description":"支持网址多轮(10 次)网络测速(DNS / 连接 / TTFB / 总耗时),并查询站点完整信息(IP / 地域 / CDN/HTTPS 证书 / 响应状态),输出测速统计数据(均值 / 中位数 / 方差等)","version":"1.0.0"},"paths":{"/v1/ping.php":{"get":{"summary":"网站Ping","description":"支持网址多轮(10 次)网络测速(DNS / 连接 / TTFB / 总耗时),并查询站点完整信息(IP / 地域 / CDN/HTTPS 证书 / 响应状态),输出测速统计数据(均值 / 中位数 / 方差等)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","example":"https://baidu.com"},"description":"需要进行多ping的url,注:需要携带协议头,如:http://xiaoapi.cn/"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"需要进行的ping次数,仅可为:1-10次,默认ping1次"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"网站Ping","description":"支持网址多轮(10 次)网络测速(DNS / 连接 / TTFB / 总耗时),并查询站点完整信息(IP / 地域 / CDN/HTTPS 证书 / 响应状态),输出测速统计数据(均值 / 中位数 / 方差等)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","example":"https://baidu.com"},"description":"需要进行多ping的url,注:需要携带协议头,如:http://xiaoapi.cn/"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"需要进行的ping次数,仅可为:1-10次,默认ping1次"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"msg": "测速完成(共测试10次)",
"data": {
"basic": {
"url": "http://xiaoapi.cn/",
"domain": "xiaoapi.cn",
"scheme": "http",
"port": 80,
"is_https": false,
"ip": "134.31.190.31",
"location": "CN-Zhejiang-Hangzhou",
"cdn": {
"is_cdn": false,
"cdn_provider": "未使用CDN"
},
"https_cert": {
"valid": false,
"issuer": "",
"start_time": "",
"expire_time": "",
"days_remaining": 0
},
"response": {
"status_code": 200,
"status_text": "OK(请求成功)",
"server": "nginx",
"content_encoding": "gzip",
"content_length": 0,
"charset": "UTF-8"
}
},
"timing": {
"dns": [
10.3,
0.03,
0.02,
0.03,
0.02,
0.02,
0.03,
0.02,
0.02,
0.03
],
"connect": [
13.71,
0.03,
0.03,
0.03,
0.03,
0.03,
0.03,
0.03,
0.03,
0.03
],
"ttfb": [
63.63,
48.24,
44.35,
43.15,
42.1,
46.24,
43.48,
45.15,
46.15,
41.76
],
"total": [
63.68,
48.27,
44.4,
43.18,
42.14,
46.28,
43.53,
45.2,
46.19,
41.8
]
},
"statistics": {
"max": "63.68ms",
"min": "41.8ms",
"average": "46.47ms",
"median": "44.8ms",
"std_dev": "6.05ms",
"variance": "36.55ms²"
}
},
"tips": "慕名API:http://xiaoapi.cn"
}
对目标网站进行多轮网络测速,涵盖 DNS 解析、连接建立、首字节等待及总耗时四个维度,并自动查询站点的 IP 地址、地理位置、CDN 使用情况及 HTTPS 证书状态,输出完整的响应头信息与统计汇总(最大值、最小值、平均值、中位数、标准差、方差)。适用于需要全面评估目标站点网络性能与基础信息的开发者或运维人员。
GET /v1/ping.php
支持 GET 方法发起请求。
无需密钥即可调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | url | 是 | 需要进行多 ping 的 URL,需携带协议头(如:http://xiaoapi.cn/) |
| n | integer | 否 | ping 次数,可选值 1-10,默认值为 1 |
{
"code": 200,
"msg": "测速完成(共测试10次)",
"data": {
"basic": {
"url": "http://xiaoapi.cn/",
"domain": "xiaoapi.cn",
"scheme": "http",
"port": 80,
"is_https": false,
"ip": "134.31.190.31",
"location": "CN-Zhejiang-Hangzhou",
"cdn": {
"is_cdn": false,
"cdn_provider": "未使用CDN"
},
"https_cert": {
"valid": false,
"issuer": "",
"start_time": "",
"expire_time": "",
"days_remaining": 0
},
"response": {
"status_code": 200,
"status_text": "OK(请求成功)",
"server": "nginx",
"content_encoding": "gzip",
"content_length": 0,
"charset": "UTF-8"
}
},
"timing": {
"dns": [10.3, 0.03, 0.02, 0.03, 0.02, 0.02, 0.03, 0.02, 0.02, 0.03],
"connect": [13.71, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03],
"ttfb": [63.63, 48.24, 44.35, 43.15, 42.1, 46.24, 43.48, 45.15, 46.15, 41.76],
"total": [63.68, 48.27, 44.4, 43.18, 42.14, 46.28, 43.53, 45.2, 46.19, 41.8]
},
"statistics": {
"max": "63.68ms",
"min": "41.8ms",
"average": "46.47ms",
"median": "44.8ms",
"std_dev": "6.05ms",
"variance": "36.55ms²"
}
},
"tips": "慕名API:http://xiaoapi.cn"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码,200 表示成功 |
| msg | string | 状态描述信息 |
| tips | string | 接口提示信息 |
| data | object | 测速结果数据对象 |
| 字段 | 类型 | 说明 |
|---|---|---|
| url | string | 请求的完整 URL |
| domain | string | 解析出的域名 |
| scheme | string | 协议类型(http/https) |
| port | integer | 端口号 |
| is_https | boolean | 是否启用 HTTPS |
| ip | string | 目标服务器 IP 地址 |
| location | string | 服务器地理位置 |
| cdn | object | CDN 配置信息 |
| https_cert | object | HTTPS 证书信息 |
| response | object | HTTP 响应头信息 |
| 字段 | 类型 | 说明 |
|---|---|---|
| is_cdn | boolean | 是否使用 CDN 加速 |
| cdn_provider | string | CDN 服务提供商名称 |
| 字段 | 类型 | 说明 |
|---|---|---|
| valid | boolean | 证书是否有效 |
| issuer | string | 证书颁发机构 |
| start_time | string | 证书生效时间 |
| expire_time | string | 证书过期时间 |
| days_remaining | integer | 剩余有效天数 |
| 字段 | 类型 | 说明 |
|---|---|---|
| status_code | integer | HTTP 状态码 |
| status_text | string | 状态码描述 |
| server | string | 服务器类型 |
| content_encoding | string | 内容编码方式 |
| content_length | integer | 内容长度(字节) |
| charset | string | 字符编码集 |
| 字段 | 类型 | 说明 |
|---|---|---|
| dns | array | DNS 解析耗时数组(单位:毫秒),数组长度由参数 n 决定 |
| connect |
当请求处理失败时,接口将返回错误信息,响应体为 JSON 格式。
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}
{
"code": 0,
"msg": "请求过于频繁,请稍后再试",
"errcode": 11005
}
{
"code": 0,
"msg": "***请求失败",
"errcode": 11016
}
| 错误码 | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
curl -X GET "https://api.xiaoapi.cn/v1/ping.php?url=https://baidu.com&n=5"
// PHP 示例
$url = "https://baidu.com";
$n = 5;
$apiUrl = "https://api.xiaoapi.cn/v1/ping.php?url=" . urlencode($url) . "&n=" . $n;
$response = file_get_contents($apiUrl);
echo $response;
协议头必填:url 参数必须携带完整协议头(http:// 或 https://),否则请求将失败。正确示例:https://baidu.com,错误示例:baidu.com。
测速次数限制:n 参数仅接受 1-10 的整数,超出范围将使用默认值(1次)。若需获取更稳定的统计数据,建议设置 5-10 次。
测速结果受网络环境影响:本地网络波动、DNS 缓存、目标服务器负载等因素均会影响测速数据的准确性,单次测速结果不宜作为性能评估的绝对依据,建议参考多次测速的统计数据(均值、中位数)综合判断。
目标站点需可公网访问:此接口通过公网对目标 URL 进行真实网络探测,内网地址或防火墙拦截的站点将无法返回有效结果。
响应耗时单位:返回的 timing 数据(dns、connect、ttfb、total)单位均为毫秒(ms),statistics 中的统计数据同样以 ms 为单位。
HTTPS 证书信息仅 HTTPS 站点返回:https_cert 字段仅在 scheme 为 https 时包含有效数据,HTTP 站点该字段值为空或默认值。
合理控制请求频率:尽管本接口免费使用,仍建议避免短时间内高频调用,以免对目标站点造成额外压力或触发本服务限流机制。
curl -s "https://api.xiaoapi.cn/v1/ping.php?url=https://baidu.com&n=1"
// 结果将在此处显示