本文へジャンプします。

ニフティクラウド APIリファレンス

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.cloud.nifty.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 以上