多节点检测 API

通过 Globalping 全球探针网络，从中国各地或世界各地的节点对目标做 Ping / TCPing、HTTP 测速、DNS 解析和路由追踪，按国家、城市汇总

数据来源：Globalping

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

多节点 Ping / TCPing：各地延迟与丢包

GET /api/probe/ping

请求参数

• target（必填）：公网域名或 IP（不允许内网 / 保留地址和 localhost），示例 www.baidu.com
• region：探针地区：china（中国大陆）/ asia / europe / northamerica / southamerica / africa / oceania / world（全球分布）/ 两位国家代码（如 US、JP、HK），示例 china
• limit：探针数量，1~20；每个探针都计入 Globalping 额度，示例 5
• protocol：icmp（普通 Ping）或 tcp（TCPing，测 TCP 握手耗时），示例 icmp
• port：TCP 端口（仅 protocol=tcp 时有效），1~65535，示例 443
• packets：每个探针发送的包数，1~10，示例 3

返回字段

• target（string）：检测目标（ASCII 域名或 IP）
• region（string）：探针地区：china、asia 等或大写国家代码
• limit（number）：请求的探针数量上限
• measurementId（string）：Globalping 测量 id，可在 https://globalping.io 查看
• status（string）：测量状态：finished 已完成；in-progress 表示等待超时，返回的是部分结果
• partial（boolean）：是否为部分结果（约 25 秒内未全部完成）；部分结果不缓存
• probesCount（number）：Globalping 实际分配的探针数（该地区探针不足时少于 limit）
• results（array）：每个探针的延迟结果，顺序与 Globalping 返回一致
• results[].country（string|null）：探针所在国家 / 地区代码（ISO 3166-1 两位，如 CN、US）
• results[].countryName（string|null）：国家 / 地区中文名（如 中国、美国）
• results[].state（string|null）：州 / 省代码；Globalping 目前只为美国探针提供（如 CA），其他国家为 null
• results[].city（string|null）：探针所在城市（英文，如 Beijing、Shanghai）
• results[].continent（string|null）：大洲代码（AS 亚洲、EU 欧洲、NA 北美、SA 南美、AF 非洲、OC 大洋洲）
• results[].asn（number|null）：探针所在网络的 ASN（自治系统号，如 4134 为中国电信）
• results[].network（string|null）：探针所在网络 / 运营商名称（英文，如 China Telecom）
• results[].latitude（number|null）：探针大致纬度（城市级）
• results[].longitude（number|null）：探针大致经度（城市级）
• results[].status（string）：该探针的检测状态：finished 完成、failed 失败、offline 探针离线、in-progress 超时未完成（partial 时出现）
• results[].error（string|null）：失败原因（取自探针原始输出的第一行）；成功完成时为 null
• results[].ok（boolean）：该探针是否成功
• results[].latency（number|null）：平均往返时间（毫秒）；未收到任何回复时为 null
• summary（object）：汇总，便于前端画表格
• summary.probes（number）：探针总数
• summary.ok（number）：成功的探针数
• summary.failed（number）：已结束但失败的探针数（含离线）
• summary.pending（number）：超时未完成的探针数（partial 时大于 0）
• summary.avg（number|null）：所有成功探针的平均延迟（毫秒）
• summary.min（number|null）：最低延迟（毫秒）
• summary.max（number|null）：最高延迟（毫秒）
• summary.lossRate（number|null）：整体丢包率（百分比，所有已完成探针的包数合计；仅 Ping 有，其他类型为 null）

多节点 HTTP 测速：DNS、TCP、TLS、首字节、下载、总耗时与状态码

GET /api/probe/http

请求参数

• url（必填）：公网网址；不带协议时按 https 处理，示例 https://www.baidu.com/
• region：探针地区：china（中国大陆）/ asia / europe / northamerica / southamerica / africa / oceania / world（全球分布）/ 两位国家代码（如 US、JP、HK），示例 china
• limit：探针数量，1~20；每个探针都计入 Globalping 额度，示例 5
• method：请求方法：HEAD 或 GET，示例 HEAD
• http2：1 = 用 HTTP/2 请求（仅 https 网址），示例 0

返回字段

• target（string）：检测目标（ASCII 域名或 IP）
• region（string）：探针地区：china、asia 等或大写国家代码
• limit（number）：请求的探针数量上限
• measurementId（string）：Globalping 测量 id，可在 https://globalping.io 查看
• status（string）：测量状态：finished 已完成；in-progress 表示等待超时，返回的是部分结果
• partial（boolean）：是否为部分结果（约 25 秒内未全部完成）；部分结果不缓存
• probesCount（number）：Globalping 实际分配的探针数（该地区探针不足时少于 limit）
• results（array）：每个探针的总耗时结果，顺序与 Globalping 返回一致
• results[].country（string|null）：探针所在国家 / 地区代码（ISO 3166-1 两位，如 CN、US）
• results[].countryName（string|null）：国家 / 地区中文名（如 中国、美国）
• results[].state（string|null）：州 / 省代码；Globalping 目前只为美国探针提供（如 CA），其他国家为 null
• results[].city（string|null）：探针所在城市（英文，如 Beijing、Shanghai）
• results[].continent（string|null）：大洲代码（AS 亚洲、EU 欧洲、NA 北美、SA 南美、AF 非洲、OC 大洋洲）
• results[].asn（number|null）：探针所在网络的 ASN（自治系统号，如 4134 为中国电信）
• results[].network（string|null）：探针所在网络 / 运营商名称（英文，如 China Telecom）
• results[].latitude（number|null）：探针大致纬度（城市级）
• results[].longitude（number|null）：探针大致经度（城市级）
• results[].status（string）：该探针的检测状态：finished 完成、failed 失败、offline 探针离线、in-progress 超时未完成（partial 时出现）
• results[].error（string|null）：失败原因（取自探针原始输出的第一行）；成功完成时为 null
• results[].ok（boolean）：该探针是否成功
• results[].latency（number|null）：总耗时（毫秒）；请求失败时为 null
• summary（object）：汇总，便于前端画表格
• summary.probes（number）：探针总数
• summary.ok（number）：成功的探针数
• summary.failed（number）：已结束但失败的探针数（含离线）
• summary.pending（number）：超时未完成的探针数（partial 时大于 0）
• summary.avg（number|null）：所有成功探针的平均总耗时（毫秒）
• summary.min（number|null）：最低总耗时（毫秒）
• summary.max（number|null）：最高总耗时（毫秒）
• summary.lossRate（number|null）：整体丢包率（百分比，所有已完成探针的包数合计；仅 Ping 有，其他类型为 null）

多节点 DNS 解析：各地解析结果对比（可看出 CDN 调度与污染）

GET /api/probe/dns

请求参数

• domain（必填）：要解析的公网域名，示例 www.baidu.com
• type：记录类型：A / AAAA / CNAME / MX / NS / TXT / SOA / CAA / SRV / HTTPS，示例 A
• region：探针地区：china（中国大陆）/ asia / europe / northamerica / southamerica / africa / oceania / world（全球分布）/ 两位国家代码（如 US、JP、HK），示例 china
• limit：探针数量，1~20；每个探针都计入 Globalping 额度，示例 5
• resolver：指定公网 DNS 服务器 IP（如 223.5.5.5）；不填用探针默认的 DNS，示例 223.5.5.5

返回字段

• target（string）：检测目标（ASCII 域名或 IP）
• region（string）：探针地区：china、asia 等或大写国家代码
• limit（number）：请求的探针数量上限
• measurementId（string）：Globalping 测量 id，可在 https://globalping.io 查看
• status（string）：测量状态：finished 已完成；in-progress 表示等待超时，返回的是部分结果
• partial（boolean）：是否为部分结果（约 25 秒内未全部完成）；部分结果不缓存
• probesCount（number）：Globalping 实际分配的探针数（该地区探针不足时少于 limit）
• results（array）：每个探针的查询耗时结果，顺序与 Globalping 返回一致
• results[].country（string|null）：探针所在国家 / 地区代码（ISO 3166-1 两位，如 CN、US）
• results[].countryName（string|null）：国家 / 地区中文名（如 中国、美国）
• results[].state（string|null）：州 / 省代码；Globalping 目前只为美国探针提供（如 CA），其他国家为 null
• results[].city（string|null）：探针所在城市（英文，如 Beijing、Shanghai）
• results[].continent（string|null）：大洲代码（AS 亚洲、EU 欧洲、NA 北美、SA 南美、AF 非洲、OC 大洋洲）
• results[].asn（number|null）：探针所在网络的 ASN（自治系统号，如 4134 为中国电信）
• results[].network（string|null）：探针所在网络 / 运营商名称（英文，如 China Telecom）
• results[].latitude（number|null）：探针大致纬度（城市级）
• results[].longitude（number|null）：探针大致经度（城市级）
• results[].status（string）：该探针的检测状态：finished 完成、failed 失败、offline 探针离线、in-progress 超时未完成（partial 时出现）
• results[].error（string|null）：失败原因（取自探针原始输出的第一行）；成功完成时为 null
• results[].ok（boolean）：该探针是否成功
• results[].latency（number|null）：DNS 查询耗时（毫秒）；失败时为 null
• summary（object）：汇总，便于前端画表格
• summary.probes（number）：探针总数
• summary.ok（number）：成功的探针数
• summary.failed（number）：已结束但失败的探针数（含离线）
• summary.pending（number）：超时未完成的探针数（partial 时大于 0）
• summary.avg（number|null）：所有成功探针的平均查询耗时（毫秒）
• summary.min（number|null）：最低查询耗时（毫秒）
• summary.max（number|null）：最高查询耗时（毫秒）
• summary.lossRate（number|null）：整体丢包率（百分比，所有已完成探针的包数合计；仅 Ping 有，其他类型为 null）

多节点路由追踪：各地到目标经过的每一跳

GET /api/probe/traceroute

请求参数

• target（必填）：公网域名或 IP（不允许内网 / 保留地址和 localhost），示例 www.baidu.com
• region：探针地区：china（中国大陆）/ asia / europe / northamerica / southamerica / africa / oceania / world（全球分布）/ 两位国家代码（如 US、JP、HK），示例 china
• limit：探针数量，1~5；每个探针都计入 Globalping 额度，示例 3
• protocol：icmp / tcp / udp，示例 icmp
• port：端口（仅 tcp / udp 有效），1~65535，示例 80

返回字段

• target（string）：检测目标（ASCII 域名或 IP）
• region（string）：探针地区：china、asia 等或大写国家代码
• limit（number）：请求的探针数量上限
• measurementId（string）：Globalping 测量 id，可在 https://globalping.io 查看
• status（string）：测量状态：finished 已完成；in-progress 表示等待超时，返回的是部分结果
• partial（boolean）：是否为部分结果（约 25 秒内未全部完成）；部分结果不缓存
• probesCount（number）：Globalping 实际分配的探针数（该地区探针不足时少于 limit）
• results（array）：每个探针的末跳延迟结果，顺序与 Globalping 返回一致
• results[].country（string|null）：探针所在国家 / 地区代码（ISO 3166-1 两位，如 CN、US）
• results[].countryName（string|null）：国家 / 地区中文名（如 中国、美国）
• results[].state（string|null）：州 / 省代码；Globalping 目前只为美国探针提供（如 CA），其他国家为 null
• results[].city（string|null）：探针所在城市（英文，如 Beijing、Shanghai）
• results[].continent（string|null）：大洲代码（AS 亚洲、EU 欧洲、NA 北美、SA 南美、AF 非洲、OC 大洋洲）
• results[].asn（number|null）：探针所在网络的 ASN（自治系统号，如 4134 为中国电信）
• results[].network（string|null）：探针所在网络 / 运营商名称（英文，如 China Telecom）
• results[].latitude（number|null）：探针大致纬度（城市级）
• results[].longitude（number|null）：探针大致经度（城市级）
• results[].status（string）：该探针的检测状态：finished 完成、failed 失败、offline 探针离线、in-progress 超时未完成（partial 时出现）
• results[].error（string|null）：失败原因（取自探针原始输出的第一行）；成功完成时为 null
• results[].ok（boolean）：该探针是否成功
• results[].latency（number|null）：到达目标那一跳的平均 RTT（毫秒）；未到达目标或失败时为 null
• summary（object）：汇总，便于前端画表格
• summary.probes（number）：探针总数
• summary.ok（number）：成功的探针数
• summary.failed（number）：已结束但失败的探针数（含离线）
• summary.pending（number）：超时未完成的探针数（partial 时大于 0）
• summary.avg（number|null）：所有成功探针的平均末跳延迟（毫秒）
• summary.min（number|null）：最低末跳延迟（毫秒）
• summary.max（number|null）：最高末跳延迟（毫秒）
• summary.lossRate（number|null）：整体丢包率（百分比，所有已完成探针的包数合计；仅 Ping 有，其他类型为 null）