ニフクラAPI (ESS: VerifyEmailIdentity)

VerifyEmailIdentity

処理概要

指定したメールアドレスを送信元IDとして登録し、メールアドレスを所有していることを確認するための検証手続きを開始します。
レスポンスとは別に、指定したアドレスに確認メールが送られる。メールに記載されているURLにアクセスすることで検証手続きは完了します。
メールアドレスの所有が確認できると、このメールアドレスからのメール送信が可能になります。

指定するパラメーター

パラメーター	型	説明	必須
EmailAddress	string	検証するメールアドレス 使用可能文字: 最大255文字	○

応答フィールド

フィールド (項目)	型	説明
VerifyEmailIdentityResponse	structure	ルート
␣VerifyEmailIdentityResult	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: 20140320T093842Z
Content-Length: 86

Action=VerifyEmailIdentity&EmailAddress=localpart%40example.com&Version=2010-12-01N2014-05-28

  

応答サンプル

    HTTP/1.1 200 OK
Date: Thu, 20 Mar 2014 09:38:42 GMT
x-amzn-RequestId: c2da1a52-7f38-437f-a356-e544209bf070
X-Nifty-RequestId: c2da1a52-7f38-437f-a356-e544209bf070
Content-Type: text/xml
Content-Length: 199
Connection: close

<VerifyEmailIdentityResponse>
  <VerifyEmailIdentityResult/>
  <ResponseMetadata>
   <RequestId>c2da1a52-7f38-437f-a356-e544209bf070</RequestId>
  </ResponseMetadata>
</VerifyEmailIdentityResponse>