本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> ESS> SendRawEmail
本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/ess/api/SendRawEmail.htmへ移行しました。 今後は新ページをご参照ください。

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>

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

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