Commercial API · 已接入 API Key / 配额统计

Kaluo API 接入文档

面向站长、运维团队和企业客户的网络拨测 API。当前支持综合检测、批量检测、HTTP、Ping、TCPing、DNS、下载测速、SEO、路由、Header、Whois、SSL，并已接入六号易支付购买后的 API Key、日配额、调用量统计和后台查看。

认证方式

推荐使用请求头传递 API Key。也兼容 URL 参数，便于低代码平台和浏览器调试。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/check?target=kaluo.net&port=80"

curl "https://kaluo.net/api/check?target=kaluo.net&port=80&api_key=kal_xxx"

专业版每日 2000 次，30 天有效期

企业版每日 20000 次，365 天有效期，可扩展私有节点/白标

配额响应头

携带有效 API Key 时，所有 API 响应会返回额度提示，方便客户侧做限流和监控。

X-Kaluo-API-Quota: 2000
X-Kaluo-API-Used: 12
X-Kaluo-API-Remaining: 1988

接口列表

GET

/api/check

综合检测：DNS + TCP + HTTP + Ping，返回评分。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/check?target=kaluo.net&port=80"

GET

/api/http

HTTP 状态、耗时、最终地址、响应头。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/http?url=https://kaluo.net"

GET

/api/ping

ICMP Ping，适合基础连通性判断。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/ping?target=kaluo.net"

GET

/api/tcping

TCP 端口连通检测。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/tcping?target=kaluo.net&port=443"

GET

/api/dns

DNS 解析查询。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/dns?target=kaluo.net"

GET

/api/download

下载测速接口；网页测速以浏览器直连测速节点为准，API 调用按后端安全限制执行。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/download?url=https://speed.cloudflare.com/__down?bytes=10000000"

GET

/api/seo

SEO 综合查询：标题、描述、关键词、H1、canonical、内外链、图片 ALT 和基础评分。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/seo?url=https://kaluo.net"

GET

/api/route

路由查询：从当前节点发起 tracepath/traceroute，返回网络跳点和原始输出。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/route?target=kaluo.net"

GET

/api/header

Header 查询：返回 URL 状态码、最终地址、Server、Content-Type、Cache-Control 和完整响应头。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/header?url=https://kaluo.net"

GET

/api/domain

域名查询：合并 Whois、到期时间、DNS 概览和原始输出。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/domain?target=kaluo.net"

GET

/api/security

安全头检测：HTTPS、HSTS、CSP、X-Frame、nosniff 等。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/security?url=https://kaluo.net"

GET

/api/dns-propagation

DNS 传播检测：多公共解析器查询 A/AAAA/MX/NS/TXT。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/dns-propagation?target=kaluo.net&type=A"

GET

/api/robots

robots.txt 检测：状态、大小、Sitemap 声明。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/robots?url=https://kaluo.net"

GET

/api/sitemap

Sitemap 检测：读取 sitemap.xml 并抽样统计 URL。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/sitemap?url=https://kaluo.net"

GET

/api/ssl

SSL 证书检测：返回颁发者、有效期、剩余天数、证书域名和 TLS 信息。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/ssl?target=kaluo.net"

GET

/api/batch

批量检测，最多 10 个目标；tool 支持 check/http/dns/tcping。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/batch?tool=check&targets=kaluo.net,example.com&port=80"

账户与用量

GET

/api/account/me

查看当前 API Key 的套餐、到期时间、今日用量和剩余额度。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/account/me"

Admin

/api/admin/api-usage

后台接口：查询 API Key 调用量统计，需要后台 Basic Auth。

curl -u USER:PASS "https://kaluo.net/api/admin/api-usage"

返回示例

{
  "ok": true,
  "tool": "check",
  "target": "kaluo.net",
  "duration": "1.2s",
  "result": {
    "score": 100
  }
}

错误码

401缺少 API Key，例如调用 /api/account/me 未提供 Key。

402API Key 无效、已过期或今日配额已用完。

429IP 请求过于频繁，触发基础频率限制。

400参数错误，例如目标为空、URL 不合法、禁止检测内网/保留地址。

商业 API 说明

当前公共工具页仍可体验；付费 API Key 已用于识别客户、统计调用量、返回配额头。正式上线前建议开启 HTTPS、接入正式账号体系和数据库持久化。

购买套餐查询 API Key 用量进入用户中心