SendEmail
処理概要
入力データを基にしてメールメッセージを組み立てて、即時に作成したメッセージを送信します。
送信元のメールアドレスは、検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスとしてください。
メッセージの合計サイズ(Message.Body.Text.DataとMessage.Body.Html.Dataのデータ合計)は2MBを超えることはできません。
1通のメッセージにおける TO:、CC:、BCC:のメールアドレス合計数は 50 を超えることはできません。
より多くの人にメールメッセージを送信したい場合には、50個以下のグループに受信者リストを分割し、グループごとにそれぞれリクエストを出してメッセージを送信すれば可能です。
指定するパラメーター
パラメーター | 型 | 説明 | 必須 |
---|---|---|---|
Destination.ToAddresses.member.n | string |
メールの送信先:宛先(To) 使用可能文字: 最大255文字。 nは1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。 |
○ (メールの送信先として、宛先(To)・同報(Cc)・隠された同報(Bcc)いずれか必須) |
Destination.CcAddresses.member.n | string |
メールの送信先:同報(Cc) 使用可能文字: 最大255文字。 nは1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。 |
○ (メールの送信先として、宛先(To)・同報(Cc)・隠された同報(Bcc)いずれか必須) |
Destination.BccAddresses.member.n | string |
メールの送信先:隠された同報(Bcc) 使用可能文字: 最大255文字。 nは1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。 |
○ (メールの送信先として、宛先(To)・同報(Cc)・隠された同報(Bcc)いずれか必須) |
Message.Subject.Data | string |
送信するメッセージ内容:件名(Subject) |
○ (送信するメッセージ内容はいずれか必須) |
Message.Subject.Charset | string |
送信するメッセージ内容:件名の文字コード |
○ (送信するメッセージ内容はいずれか必須) |
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 |
メールの返信先のリスト。 使用可能文字: 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスを使用可能。 nは1〜10の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。 |
|
ReturnPath | string |
送信不達の際の通知(バウンスメール)を転送するアドレス。 使用可能文字: 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスを使用可能。 |
|
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>