VerifyDomainIdentity
処理概要
指定したドメインを送信元IDとして登録し、ドメインを所有していることを確認するための検証手続きを開始します。
レスポンスの VerificationToken の値を、DNSサーバの TXT レコードに設定することで、検証手続きは完了します。
ドメインの所有が確認できると、個々にメールアドレスを検証しなくても、そのドメインに所属するすべてのメールアドレスからのメール送信が可能になります。
指定するパラメーター
| パラメーター | 型 | 説明 | 必須 |
|---|---|---|---|
| Domain | string |
検証するドメイン 使用可能文字: 最大255文字 |
○ |
応答フィールド
| フィールド (項目) | 型 | 説明 |
|---|---|---|
| VerifyDomainIdentityResponse | structure |
ルート |
| ␣VerifyDomainIdentityResult | structure |
結果 |
| ␣␣VerificationToken | string |
検証トークン |
| ␣ResponseMetadata | structure |
共通メタ情報 |
| ␣␣RequestId | string |
リクエスト識別子 |
エラー
| コード | メッセージ | タイプ | HTTPステータスコード | 説明 |
|---|---|---|---|---|
| ValidationError | Sender | 400 | パラメーターが不正です。 | |
| InvalidParameterValue | Sender | 400 | 無効な値または範囲外の値を入力パラメーターに指定しています。 | |
| Throttling | Sender | 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
X-Nifty-Date: 20140320T090748Z
Content-Length: 68
Action=VerifyDomainIdentity&Domain=example.com&Version=2010-12-01N2014-05-28
応答サンプル
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>
