ニフクラAPI (ESS: SendRawEmail)

SendRawEmail

処理概要

メールヘッダーおよびボディからなるメールメッセージの生のテキストデータを指定してメールを送信します。
SendRawEmail アクションは、マルチパートMIMEメールを送信する場合に便利です。
メッセージの生のテキストは、インターネットのメールの規格に準拠している必要があり、そうでない場合メッセージは送信できません。

送信元のメールアドレスは、検証済みのメールアドレスもしくは検証済みのドメイン下のメールアドレスとしてください。

メッセージの合計サイズ(RawMessage.Dataのbase64デコード後のサイズ)は2MBを超えることはできません。
添付ファイル等メッセージを構成するすべてのデータを含みます。
1通のメッセージにおける TO：、CC：、BCC：のメールアドレス合計数は 50 を超えることはできません。

50個以下のグループに受信者リストを分割し、グループごとにそれぞれリクエストを出してメッセージを送信すれば可能です。

指定するパラメーター

パラメーター	型	説明	必須
Destinations.member.n	string	メールの送信先のリスト 使用可能文字: nは1〜50の数字。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _ ! # $ % & ' * / = ? ^ ` { | } ~)。 表示名はMIME encode形式(RFC 2047) で指定。
RawMessage.Data	string	送信するメッセージの生のテキストデータをBase64変換したもの。 以下の要件を満たす必要があります。 ・メッセージは間に空行を挟んだ1つのヘッダと1つのボディで構成してください。 ・必須となっているすべてのヘッダフィールドを存在させてください。 ・マルチパートMIMEメッセージのすべてのパートは適切な形式としてください。	○
Source	string	メールの送信元。 ※Sourceを指定した場合には、バウンスメールはこのアドレスに届けられる。メッセージ内に書かれたReturn-Pathヘッダは無視されます。 使用可能文字: 検証済みのメールアドレスもしくは検証済みのドメインのメールアドレスを使用可能。 「メールアドレス」または「表示名 <メールアドレス>」の形式。 メールアドレスのローカルパート(@より前の文字列)に使用できる文字は、英数字と記号(. + - _)。 表示名はMIME encode形式(RFC 2047) で指定。

応答フィールド

フィールド (項目)	型	説明
SendRawEmailResponse	structure	ルート
␣SendRawEmailResult	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: 307

Action=SendRawEmail&Version=2010-12-01N2014-05-28&RawMessage.Data=RnJvbTogdGVzdDAwMUXlc3・・・・・

  

応答サンプル

    HTTP/1.1 200 OK
Date: Thu, 20 Mar 2014 07:05:21 GMT
x-amzn-RequestId: 1410d27a-d03b-4bb9-9130-a0ecfdb50ded
X-Nifty-RequestId: 1410d27a-d03b-4bb9-9130-a0ecfdb50ded
Content-Type: text/xml
Content-Length: 278
Connection: close

<SendRawEmailResponse>
  <SendRawEmailResult>
    <MessageId>00000130feba5b-341e-4afa-9526-48ebd88e2886-000000</MessageId>
  </SendRawEmailResult>
  <ResponseMetadata>
    <RequestId>1410d27a-d03b-4bb9-9130-a0ecfdb50ded</RequestId>
  </ResponseMetadata>
</SendRawEmailResponse>