ESS：SendEmail
概要
入力データを基にしてメールメッセージを組み立てて、即時に作成したメッセージを送信します。
送信元のメールアドレスは、検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスとしてください。
メッセージの合計サイズ(Message.Body.Text.DataとMessage.Body.Html.Dataのデータ合計)は2MBを超えることはできない。
1通のメッセージにおける TO：、CC：、BCC：のメールアドレス合計数は 50 を超えることはできません。
より多くの人にメールメッセージを送信したい場合には、50個以下のグループに受信者リストを分割し、グループごとにそれぞれリクエストを出してメッセージを送信すれば可能です。
リクエストパラメーター
| 要素名 | 説明 | 必須 | 値 | 最大値 | デフォルト値 | 備考 |
|---|---|---|---|---|---|---|
| Destination.ToAddresses.member.N | メールの送信先：宛先TOの指定 | ○ | 文字列 | − | − | MIME encodeされた (RFC 2047) で指定。合計 50件まで。 |
| Destination.CcAddresses.member.N | メールの送信先：同報CCの設定 | |||||
| Destination.BccAddresses.member.N | メールの送信先：隠された同報 BCCの設定 | |||||
| Message.Subject.Data | 送信するメッセージ内容：subjectデータ | ○ | 文字列 | − | − | |
| Message.Subject.Charset | 送信するメッセージ内容：subjectの文字コード | |||||
| Message.Body.Text.Data | 送信するメッセージ内容：メール本文txtデータ | |||||
| Message.Body.Text.Charset | 送信するメッセージ内容：メール本文txtデータの文字コード | |||||
| Message.Body.Html.Data | 送信するメッセージ内容：メール本文htmlデータ | |||||
| Message.Body.Html.Charset | 送信するメッセージ内容：メール本文htmlデータの文字コード | |||||
| ReplyToAddresses.member.N | メールの返信先のリスト 受信者がメッセージに返信した場合、それぞれの返信先アドレスに返信が届く。 10件まで設定可能 |
文字列 | − | − | ||
| ReturnPath | 送信不達の際の通知(バウンスメール)を転送するアドレス ReturnPathを指定した場合このアドレスにメッセージを転送する。 |
文字列 | − | − | ||
| Source | メールの送信元 デフォルトでは、文字列は7ビットASCIIでなければならない。他の文字が含まれている場合には、MIME形式でエンコードする必要がある。MIME形式でエンコードすると次の形式になる =? charset?エンコーディング?エンコードされたテキスト?= 。詳細については、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>
