本文へジャンプします。

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

ESS:SendRawEmail

概要

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

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

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

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

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
Destinations.member.N メールの送信先のリスト   文字列  
RawMessage.Data

送信するメッセージの生のテキストデータをBase64変換したもの。

以下の要件を満たす必要があります。

  • メッセージは間に空行を挟んだ1つのヘッダと1つのボディで構成してください。
  • 必須となっているすべてのヘッダフィールドを存在させてください。
  • マルチパートMIMEメッセージのすべてのパートは適切な形式としてください。
文字列  
Source

メールの送信元
デフォルトでは、文字列は7ビットASCIIでなければならない。他の文字が含まれている場合には、MIME形式でエンコードする必要があります。MIME形式でエンコードすると次の形式になる =? charset?エンコーディング?エンコードされたテキスト?= 。詳細については、RFC2047参照してください。

  • ※Sourceを指定した場合には、バウンスメールとクレームメールはこのアドレスに届けられる。メッセージ内に書かれたReturn-Pathヘッダは無視されます。
  文字列  

レスポンス

要素名 説明 備考
SendRawEmailResponse ルート  
SendRawEmailResult 結果  
MessageId メッセージを一意に特定するために生成されたメッセージID 文字列  
ResponseMetadata 共通メタ情報  

エラー

エラー種別 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: 307

Action=SendRawEmail&Version=2010-12-01&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>

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