public
GET /v1/public/domains/whois
Free public WHOIS lookup for any domain.
Упълномощаване
Този крайpoint е публичен. Той не изисква данни за удостоверяване и организация — това е съдържанието, което нашият собствен маркетинг сайт и AI машини за отговори четат.
Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.
Опитайте
Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.
curl -X GET https://api.zinndigital.com/v1/public/domains/whois?domain=<domain>Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в 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. |
Грешки, които този крайpoint може да върне
422 · 429 · 503