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

Kaluo API 接入文档

面向站长、运维团队和企业客户的网络拨测 API。当前支持综合检测、批量检测、HTTP、Ping、TCPing、DNS、下载测速、SEO、路由、Header、Whois，并已接入六号易支付购买后的 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

下载测速，单次最多读取 20MB，30 秒超时。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/download?url=https://example.com/file.zip"

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/whois

Whois 查询：返回注册商、创建时间、到期时间、Name Server 和原始输出。

curl -H "X-API-Key: kal_xxx" "https://kaluo.net/api/whois?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,
    "node": "de-dev-01"
  }
}

错误码

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

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

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

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

商业 API 说明

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

购买套餐查询 API Key 用量后台查看 API Key / 调用量