Аутентификация
Этот эндпоинт является публичным. Он не требует учетных данных и организации — его читают наш собственный маркетинговый сайт и поисковые системы на базе ИИ.
Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.
Попробовать
Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.
curl -X GET https://api.zinndigital.com/v1/public/domains/whois?domain=<domain>Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему 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