domains

GET /v1/domains/{domainId}/restore-quote

What it costs to restore a lapsed domain.

すべての domains エンドポイント

すべての開発者向けドキュメント

認証

ベアラー トークンとして API キーを送信します。キーには sites.view 権限が付与されている必要があります。権限のないキーは 404 ではなく 403 で拒否されます。

このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。

試してみる

アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。

curl -X GET https://api.zinndigital.com/v1/domains/{domainId}/restore-quote \
  -H "Authorization: Bearer zdk_live_…"

ログインしていますか?ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く

詳細

The registry redemption fee for a domain that has fallen into redemption, and whether it can be restored at all. Priced in the caller's display currency (X-Zinn-Currency, falling back to USD) from the TLD catalogue. A domain that has not lapsed that far needs a renewal, not a restore, and is answered restorable: false rather than quoted — a redemption fee is many times a renewal, so quoting one in the wrong state would overcharge for a renewal. Requires sites.view.

パラメータ

名前タイプ必須これがその内容です
domainId (path)UuidはいThe domain's id.

返信

名前タイプ必須これがその内容です
domain_idUuidはいUUIDv7 identifier — sortable by creation time (docs/02 §8).
fqdnstringはい
restorablebooleanはい
reasonobjectはいWhy not, when restorable is false. NOT_IN_REDEMPTION — the domain has not lapsed that far, so a renewal is what it needs. NOT_PRICED — the registry has no redemption…
amount_minorobjectはい
currencyobjectはい
line_kindstring<domain_restore>はいThe cart line kind that buys it.

このエンドポイントが返すエラー

401 · 403 · 404 · 429