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.nifcloud.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>