/ 接口详情
/ 接口详情
·
网络工具
GET / POST
网站Ping
支持网址多轮（10 次）网络测速（DNS / 连接 / TTFB / 总耗时），并查询站点完整信息（IP / 地域 / CDN/HTTPS 证书 / 响应状态），输出测速统计数据（均值 / 中位数 / 方差等）
调用 101 次
免费
KEY 必填
QPM 不限制
Query 参数、Header(X-API-Key)、Bearer Token
接口信息
GET / POST
xiaoapi.cn/v1/ping.php
方法
GET / POST
分类
网络工具
计费
免费
KEY
KEY 必填
调用
101
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)、Bearer Token
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| url | url | 是 | 需要进行多ping的url，注：需要携带协议头，如：http://xiaoapi.cn/ | https://baidu.com |
| n | integer | 否 | 需要进行的ping次数，仅可为：1-10次，默认ping1次 | 1 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"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": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"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": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"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": "https://xiaoapi.cn",
"description": "当前访问入口（https）"
}
]
}
返回示例
{
"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"
}
详细文档
网站Ping
接口说明
对目标网站进行多轮网络测速，涵盖 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 | 测速结果数据对象 |
data 基础信息（basic）
| 字段 | 类型 | 说明 |
|---|---|---|
| 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 响应头信息 |
data.CDN 配置（cdn）
| 字段 | 类型 | 说明 |
|---|---|---|
| is_cdn | boolean | 是否使用 CDN 加速 |
| cdn_provider | string | CDN 服务提供商名称 |
data.HTTPS 证书（https_cert）
| 字段 | 类型 | 说明 |
|---|---|---|
| valid | boolean | 证书是否有效 |
| issuer | string | 证书颁发机构 |
| start_time | string | 证书生效时间 |
| expire_time | string | 证书过期时间 |
| days_remaining | integer | 剩余有效天数 |
data.响应信息（response）
| 字段 | 类型 | 说明 |
|---|---|---|
| status_code | integer | HTTP 状态码 |
| status_text | string | 状态码描述 |
| server | string | 服务器类型 |
| content_encoding | string | 内容编码方式 |
| content_length | integer | 内容长度（字节） |
| charset | string | 字符编码集 |
data.测速数据（timing）
| 字段 | 类型 | 说明 |
|---|---|---|
| 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（bash）
curl -X GET "https://api.xiaoapi.cn/v1/ping.php?url=https://baidu.com&n=5"PHP
// 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"在线测试
请求地址
xiaoapi.cn/v1/ping.php
Method
参数
Response
// 结果将在此处显示
接口反馈
推荐接口
服务免责声明
生效日期：2026年7月22日
欢迎使用 xiaoapi.cn（以下简称"本平台"）。在使用本平台提供的 API 服务（以下简称"本服务"）前，请务必仔细阅读并充分理解本免责声明。您以任何方式调用、访问或使用本服务，即视为您已阅读、理解并同意接受本声明的全部内容。
一、声明目的
本平台作为 API 技术服务的提供方，仅提供技术接口与数据分发服务。本声明的目的在于明确平台与用户之间的责任边界，督促用户合法、合规地使用本服务，防范违法违规行为的发生。
二、用户责任与合规承诺
- 用户应为自身的一切调用行为承担全部责任，包括但不限于调用方式、调用目的、数据使用、结果传播及由此产生的全部后果。
- 用户承诺在使用本服务过程中，严格遵守中华人民共和国法律法规以及所在国家/地区的适用法律，包括但不限于《网络安全法》《数据安全法》《个人信息保护法》《著作权法》《刑法》及相关司法解释。
- 用户承诺不以任何方式利用本服务从事损害国家利益、社会公共利益、他人合法权益的活动。
三、禁止性行为
用户在使用本服务时，明确禁止从事以下行为：
- 利用本服务制作、复制、传播、存储任何法律法规禁止的内容，包括但不限于色情低俗、赌博、诈骗、暴力恐怖、毒品、虚假谣言等信息；
- 利用本服务从事黑客攻击、入侵、破坏、干扰、非法获取他人数据或系统权限等行为；
- 利用本服务侵犯他人知识产权、商业秘密、个人隐私或其他合法权益；
- 利用本服务实施网络诈骗、钓鱼、洗钱、电信网络诈骗等违法犯罪活动；
- 绕过本平台或第三方平台的安全机制、访问控制、收费机制或版权保护措施；
- 未经授权将本服务用于商业转售、批量恶意调用、恶意抓取、骚扰性推送等行为；
- 其他违反法律法规或本平台服务协议的行为。
四、第三方内容与数据免责
- 本服务所分发、转发或返回的部分数据、内容可能来源于第三方接口、公开网络或其他合作方，本平台对其真实性、准确性、合法性不作出任何保证。
- 因第三方内容、第三方接口异常、第三方版权纠纷或第三方平台政策变化所引发的任何争议、损失，由相关第三方承担责任，本平台不承担由此产生的责任，但将依法配合权利人和主管部门进行处理。
五、平台免责范围
在法律法规允许的最大范围内，本平台对以下情形不承担责任：
- 用户因违规、违法使用本服务所产生的全部法律责任与后果，均由用户自行承担；
- 因用户操作不当、接口误用、参数错误、网络环境异常等原因造成的损失；
- 因不可抗力（包括但不限于自然灾害、政府行为、电力故障、网络中断、第三方服务故障）导致的服务中断、延迟或数据丢失；
- 因本平台进行必要的系统维护、升级、调整而导致的服务临时不可用；
- 用户之间、用户与第三方之间因使用本服务产生的纠纷。
六、违规处理与账号管理
- 本平台有权对用户的调用行为进行监测与审查。
- 一经发现用户存在违法、违规或违反本声明的行为，本平台有权视情节轻重采取警告、限制调用、暂停服务、封禁账号等措施，并保留向有关主管部门举报、移交司法机关处理的权利。
- 因用户违规行为导致本平台被第三方索赔、被主管部门处罚或遭受其他损失的，用户应承担全部赔偿责任。
七、赔偿条款
因用户违反本声明或相关法律法规，导致本平台及其关联方、合作方遭受任何损失（包括但不限于赔偿款、罚款、律师费、诉讼费等），用户同意向本平台及相关方承担全部赔偿责任。
八、知识产权
- 本平台自身的商标、标识、界面设计、技术代码等知识产权归本平台所有，未经许可不得擅自使用。
- 用户不得利用本服务对第三方知识产权进行侵犯；因用户侵权行为引发的纠纷由用户自行负责。
九、法律适用与争议解决
- 本声明的订立、解释、变更及争议解决均适用中华人民共和国法律。
- 因本声明或本服务产生的争议，双方应友好协商解决；协商不成的，任何一方可向本平台运营方所在地有管辖权的人民法院提起诉讼。
十、声明变更
本平台有权根据法律法规变化、业务调整或监管要求，随时修改本声明。修改后的声明将在本页面公布，自公布之日起生效。您继续使用本服务，即视为接受更新后的声明。
十一、联系我们
如您对本声明有任何疑问，或发现他人存在违规使用本服务的行为，欢迎通过本平台公示的联系方式与我们联系，我们将及时处理。