public
GET /v1/public/domains/whois
Free public WHOIS lookup for any domain.
Uwierzytelnianie
Ten punkt końcowy jest publiczny. Nie wymaga żadnych poświadczeń ani organizacji — to z niego korzysta nasza własna strona marketingowa oraz silniki odpowiedzi AI.
Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.
Wypróbuj
Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.
curl -X GET https://api.zinndigital.com/v1/public/domains/whois?domain=<domain>Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API
Szczegóły
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.
Parametry
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
domain (query) | string | Tak | The domain to look up, including its extension. A trailing dot is ignored, case is ignored, and an internationalised name must already be punycoded. |
Odpowiedź
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
fqdn | string | Tak | The normalised name that was looked up (lower-cased, no trailing dot). |
state | string<registered, not_registered, unknown> | Tak | 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 | Tak | The registry record, or null for any state other than registered. |
Błędy, które ten punkt końcowy może zwrócić
422 · 429 · 503