本文へジャンプします。

ニフティクラウド APIリファレンス

クラウド トップ>API>ESS>VerifyDomainIdentity

ESS:VerifyDomainIdentity

概要

指定したドメインを送信元IDとして登録し、ドメインを所有していることを確認するための検証手続きを開始します。
レスポンスの VerificationToken の値を、DNSサーバの TXT レコードに設定することで、検証手続きは完了します。

ドメインの所有が確認できると、個々にメールアドレスを検証しなくても、そのドメインに所属するすべてのメールアドレスからのメール送信が可能になる。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
Domain 検証するドメイン 文字列 255  

レスポンス

要素名 説明 備考
VerifyDomainIdentityResponse ルート  
VerifyDomainIdentityResult 結果  
VerificationToken 検証トークン 文字列  
ResponseMetadata 共通メタ情報 -  

エラー

エラー種別 HTTPステータスコード 説明
ValidationError 400 パラメーターが不正です。
InvalidParameterValue 400 無効な値または範囲外の値を入力パラメータに指定しています。
Throttling 400 送信元メールアドレスと送信元ドメイン合計1000件より多くを指定しています。

サンプル

リクエストサンプル
POST / HTTP/1.1
Authorization: NIFTY4-HMAC-SHA256 Credential=<Credential>/20140320/east-1/email/nifty4_request, SignedHeaders=content-type;host;x-nifty-date, Signature=<Signature>
Host: ess.api.cloud.nifty.com
Content-type: application/x-www-form-urlencoded; charset=utf-8
X-Nifty-Date: 20140320T090748Z
Content-Length: 68

Action=VerifyDomainIdentity&Domain=example.com&Version=2010-12-01
レスポンスサンプル
HTTP/1.1 200 OK
Date: Thu, 20 Mar 2014 09:07:48 GMT
x-amzn-RequestId: 62383131-502c-46a8-94ea-4935a01b1588
X-Nifty-RequestId: 62383131-502c-46a8-94ea-4935a01b1588
Content-Type: text/xml
Content-Length: 341
Connection: close

<VerifyDomainIdentityResponse>
 <VerifyDomainIdentityResult>
  <VerificationToken>eb7fdc806f2576a5ee6eb0401a50f2852411dad092ded917ed704825564b54123</VerificationToken>
 </VerifyDomainIdentityResult>
 <ResponseMetadata>
  <RequestId>62383131-502c-46a8-94ea-4935a01b1588</RequestId>
 </ResponseMetadata>
</VerifyDomainIdentityResponse>

推奨画面サイズ 1024×768 以上