本文へジャンプします。

ニフクラ ユーザーガイド

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>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2021年9月17日時点の情報です。

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