身份验证
此端点是公开的。它不需要任何凭据或组织——这是我们自己的营销网站和 AI 问答引擎所读取的内容。
此端点不需要组织 ID。您的密钥已用于识别其所属的组织，且响应范围也仅限于该组织。
免费试用
将尖括号中的内容替换为您自己的值，并将键占位符替换为您仪表板中的一个键。
curl -X GET https://api.zinndigital.com/v1/public/domains/whois?domain=<domain>已登录？您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥，并针对实时 API 运行请求，以便您查看实际的响应。 在 API 控制台中打开此端点
详细信息
What the public registry says about a domain — registrar, registration and expiry dates, status codes, nameservers and DNSSEC — for any name, whether it is with us or not. No account, one domain per request. Read from RDAP (RFC 7482/7483), which the registries serve themselves and which needs no credential. state is three-valued and that is load-bearing. registered means the registry returned a record. not_registered means it answered 404 — there is no such registration. unknown means we could not find out: the extension publishes no RDAP service, the registry timed out, rate-limited us, or answered with something we could not read. ⛔ A client must never render unknown as not_registered: they send a visitor to opposite actions, and collapsing them is the defect that once offered google.com for sale with a valid checkout token. registry is null for both non-registered states. Inside it every field is nullable, and null means the registry did not publish it — never that the domain lacks it. A client rendering transfer_locked: null as "unlocked" would tell somebody to go and protect a domain that is already protected. No registrant, admin or technical contact is ever carried: post-GDPR most registries redact them, and republishing the ones that do not would be exporting personal data for no product reason. Rate limited per caller and globally, and answers are cached for 24 hours per domain. There is deliberately no bulk or CSV input — the bulk surface is the authenticated one, where the caller has an organisation.
参数
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
domain (query) | string | 是 | The domain to look up, including its extension. A trailing dot is ignored, case is ignored, and an internationalised name must already be punycoded. |
响应
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
fqdn | string | 是 | The normalised name that was looked up (lower-cased, no trailing dot). |
state | string<registered, not_registered, unknown> | 是 | registered — the registry returned a record. not_registered — the registry answered 404. unknown — we could not find out (no RDAP service for the extension, a timeout, a… |
registry | RegistryProfile | 是 | The registry record, or null for any state other than registered. |
此端点可能返回的错误
422 · 429 · 503