本文へジャンプします。

ニフクラ APIリファレンス

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>

推奨画面サイズ 1024×768 以上