TCPLab TCPLab

API 文档

最后更新: 2026-10-19

TCPLab API 提供与网页工具相同的网络查询能力,无需 API Key。按接口类型查看下方文档。

接口列表

接口 方法 说明
IP 查询 GET /api/v2/ip/{target} 查询 IPv4/IPv6 地址或域名的归属信息。
我的 IP GET /api/v2/myip 查询调用者自身 IP 的归属信息。
DNS 查询 POST /api/v2/dns/query 查询 A、AAAA、CNAME、TXT、MX、NS 记录。
WHOIS 查询 GET whois.tcp.lc/v1/whois/{domain} 通过 RDAP/WHOIS 查询域名注册商、时间、状态与 DNS 服务器。
ICP 备案查询 GET /api/v2/icp/query?domain={domain} 查询域名的 ICP 备案号、主办单位、单位性质与审核时间。
SSL 证书检测 POST /api/v2/tls/check 查询证书是否有效、到期时间、签发机构、SAN、TLS 版本与 HTTP/2 支持。
纯文本接口 GET / · GET /text 以 text/plain 返回访客 IP 与归属地,面向命令行。

通用说明

适用于 /api/v2/ 下的 JSON 接口。WHOIS 查询 与 纯文本接口 在域名与约定上不同,见各自页面。

  • 接口地址:https://tcp.lc,JSON 接口位于 /api/v2/ 下。
  • 所有 JSON 响应 HTTP 状态码恒为 200,业务状态以 code 字段为准:200 成功,-1000 失败。
  • 失败时 msg 为稳定的错误标识(如 api.param.ip.invalid),data.args 可能携带细节。
  • 允许跨域调用(Access-Control-Allow-Origin: *)。

限流

限流按客户端 IP 计算,所有请求(包括失败的请求)都计入配额,除非接口另有说明。纯文本接口 返回 text/plain,不受限流约束。

接口 限制
IP 查询 每分钟 60 次、每天 1000 次
我的 IP 每分钟 60 次、每天 1000 次
DNS 查询 每天 50 次
ICP 备案查询 每天 20 次(命中缓存不计数)
SSL 证书检测 每分钟 10 次、每天 100 次
WHOIS 查询 每分钟 10 次

超限时 /api/v2/ 接口返回 code: -1000,msg 为 api.rate.limited 或 api.rate.limitedDaily,并带 Retry-After 响应头(秒),每日额度按 UTC+8 零点重置;WHOIS 查询 则直接返回 HTTP 429。