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。