ESS:SendEmail
概要
入力データを基にしてメールメッセージを組み立てて、即時に作成したメッセージを送信します。
送信元のメールアドレスは、検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスとしてください。
メッセージの合計サイズ(Message.Body.Text.DataとMessage.Body.Html.Dataのデータ合計)は2MBを超えることはできない。
1通のメッセージにおける TO:、CC:、BCC:のメールアドレス合計数は 50 を超えることはできません。
より多くの人にメールメッセージを送信したい場合には、50個以下のグループに受信者リストを分割し、グループごとにそれぞれリクエストを出してメッセージを送信すれば可能です。
リクエストパラメーター
要素名 | 説明 | 必須 | 値 | 最大値 | デフォルト値 | 備考 |
---|---|---|---|---|---|---|
Destination.ToAddresses.member.N | メールの送信先:宛先(To) N は1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号( . + - _ ! # $ % & ' * / = ? ^ ` { | } ~ )。表示名はMIME encode形式(RFC 2047) で指定。 |
○ | 文字列 | − | − | 合計 50件まで。 |
Destination.CcAddresses.member.N | メールの送信先:同報(Cc) N は1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号( . + - _ ! # $ % & ' * / = ? ^ ` { | } ~ )。表示名はMIME encode形式(RFC 2047) で指定。 |
|||||
Destination.BccAddresses.member.N | メールの送信先:隠された同報(Bcc) N は1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号( . + - _ ! # $ % & ' * / = ? ^ ` { | } ~ )。表示名はMIME encode形式(RFC 2047) で指定。 |
|||||
Message.Subject.Data | 送信するメッセージ内容:件名(Subject) | ○ | 文字列 | − | − | |
Message.Subject.Charset | 送信するメッセージ内容:件名の文字コード (例:「UTF-8」「ISO-2022-JP」) |
|||||
Message.Body.Text.Data | 送信するメッセージ内容:メール本文 | |||||
Message.Body.Text.Charset | 送信するメッセージ内容:メール本文の文字コード | |||||
Message.Body.Html.Data | 送信するメッセージ内容:メール本文(HTML) | |||||
Message.Body.Html.Charset | 送信するメッセージ内容:メール本文(HTML)の文字コード | |||||
ReplyToAddresses.member.N | メールの返信先のリスト N は1〜10の数字。 受信者がメッセージに返信した場合、それぞれの返信先アドレスに返信が届く。 「メールアドレス」または「表示名 <メールアドレス>」の形式。メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号( . + - _ )。表示名はMIME encode形式(RFC 2047) で指定。10件まで設定可能 |
文字列 | − | − | 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレス | |
ReturnPath | 送信不達の際の通知(バウンスメール)を転送するアドレス ReturnPathを指定した場合このアドレスにメッセージを転送する。 |
文字列 | − | − | 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレス | |
Source | メールの送信元 「メールアドレス」または「表示名 <メールアドレス>」の形式。メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号( . + - _ )。表示名はMIME encode形式(RFC 2047) で指定。 |
○ | 文字列 | − | − | 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレス |
レスポンス
要素名 | 説明 | 値 | 備考 |
---|---|---|---|
SendEmailResponse | ルート | − | |
SendEmailResult | 結果 | 文字列 | |
MessageId | メッセージを一意に特定するために生成されたメッセージID | − |
エラー
エラー種別 | HTTPステータスコード | 説明 |
---|---|---|
ValidationError | 400 | パラメーターが不足です。 |
InvalidParameterValue | 400 | 無効な値または範囲外の値を入力パラメーターに指定しています。 |
MalformedInput | 400 | パラメーターが不正です。 |
MessageRejected | 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
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-01&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>