public
GET /v1/public/domains/whois
Free public WHOIS lookup for any domain.
認証
このエンドポイントは公開されています。認証情報や組織情報は不要で、当社のマーケティングサイトや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