ニフクラAPI (ESS: SendEmail)

SendEmail

処理概要

入力データを基にしてメールメッセージを組み立てて、即時に作成したメッセージを送信します。

送信元のメールアドレスは、検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスとしてください。

メッセージの合計サイズ(Message.Body.Text.DataとMessage.Body.Html.Dataのデータ合計)は2MBを超えることはできません。
1通のメッセージにおける TO：、CC：、BCC：のメールアドレス合計数は 50 を超えることはできません。
より多くの人にメールメッセージを送信したい場合には、50個以下のグループに受信者リストを分割し、グループごとにそれぞれリクエストを出してメッセージを送信すれば可能です。

指定するパラメーター

パラメーター	型	説明	必須
Destination.ToAddresses.member.n	string	メールの送信先：宛先(To) Destination.CcAddresses.member.n と Destination.BccAddresses.member.n 合わせて50件まで指定可能。 使用可能文字: 最大255文字。 nは1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。	○ (メールの送信先として、宛先(To)・同報(Cc)・隠された同報(Bcc)いずれか必須)
Destination.CcAddresses.member.n	string	メールの送信先：同報(Cc) Destination.ToAddresses.member.n と Destination.BccAddresses.member.n 合わせて50件まで指定可能。 使用可能文字: 最大255文字。 nは1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。	○ (メールの送信先として、宛先(To)・同報(Cc)・隠された同報(Bcc)いずれか必須)
Destination.BccAddresses.member.n	string	メールの送信先：隠された同報(Bcc) Destination.ToAddresses.member.n と Destination.BccAddresses.member.n 合わせて50件まで指定可能。 使用可能文字: 最大255文字。 nは1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。	○ (メールの送信先として、宛先(To)・同報(Cc)・隠された同報(Bcc)いずれか必須)
Message.Subject.Data	string	送信するメッセージ内容：件名(Subject)	○ (送信するメッセージ内容はいずれか必須)
Message.Subject.Charset	string	送信するメッセージ内容：件名の文字コード (例:「UTF-8」「ISO-2022-JP」)	○ (送信するメッセージ内容はいずれか必須)
Message.Body.Text.Data	string	送信するメッセージ内容：メール本文	○ (送信するメッセージ内容はいずれか必須)
Message.Body.Text.Charset	string	送信するメッセージ内容：メール本文の文字コード	○ (送信するメッセージ内容はいずれか必須)
Message.Body.Html.Data	string	送信するメッセージ内容：メール本文(HTML)	○ (送信するメッセージ内容はいずれか必須)
Message.Body.Html.Charset	string	送信するメッセージ内容：メール本文(HTML)の文字コード	○ (送信するメッセージ内容はいずれか必須)
ReplyToAddresses.member.n	string	メールの返信先のリスト。 受信者がメッセージに返信した場合、それぞれの返信先アドレスに返信が届く。 10件まで設定可能。 使用可能文字: 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスを使用可能。 nは1〜10の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。
ReturnPath	string	送信不達の際の通知(バウンスメール)を転送するアドレス。 ReturnPathを指定した場合このアドレスにメッセージを転送する。 使用可能文字: 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスを使用可能。
Source	string	メールの送信元 使用可能文字: 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスを使用可能。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。	○

応答フィールド

フィールド (項目)	型	説明
SendEmailResponse	structure	ルート
␣SendEmailResult	structure	結果
␣␣MessageId	string	メッセージを一意に特定するために生成されたメッセージID
␣ResponseMetadata	structure	共通メタ情報
␣␣RequestId	string	リクエスト識別子

エラー

コード	メッセージ	タイプ	HTTPステータスコード	説明
ValidationError		Sender	400	パラメーターが不足です。
InvalidParameterValue		Sender	400	無効な値または範囲外の値を入力パラメーターに指定しています。
MalformedInput		Sender	400	パラメーターが不正です。
MessageRejected		Sender	400	アクションに失敗しメッセージは送信できませんでした。付帯するエラー情報を見て原因を確認してください。

リクエストサンプル

    POST / HTTP/1.1
Authorization: NIFTY4-HMAC-SHA256 Credential=<Credential>/20140320/east-1/email/nifty4_request, SignedHeaders=host;x-nifty-date, Signature=<Signature>
Host: ess.api.nifcloud.com
Content-type: application/x-www-form-urlencoded
X-Nifty-Date: 20140320T124420Z
Content-Length: 196

Source=localpart1%40example.com&Destination.ToAddresses.member.1=localpart%40example.com&Action=SendEmail&Message.Body.Text.Data=hello&Version=2010-12-01N2014-05-28&Message.Subject.Data=test

  

応答サンプル

    HTTP/1.1 200 OK
Date: Thu, 20 Mar 2014 12:44:20 GMT
x-amzn-RequestId: cd719149-4a57-4fddP-af69-b7bc3b653b0d
X-Nifty-RequestId: cd719149-4a57-4fdd-af69-b7bc3b653b0d
Content-Type:text/xml
Content-Length: 266
Connection: close

<SendEmailResponse>
<SendEmailResult>
  <MessageId>000001fc4e1329-7ed7-4880-a35b-0ee09cc35776-000000</MessageId>
</SendEmailResult>
<ResponseMetadata>
  <RequestId>cd719149-4a57-4fdd-af69-b7bc3b653b0d</RequestId>
</ResponseMetadata>
<SendEmailResult>