生のテキストデータを指定したメール送信 (POST /)

メールヘッダーおよびボディからなる電子メールメッセージの生のテキストデータを指定してメールを送信します。

メッセージの生のテキストは、インターネット電子メールの標準に準拠している必要があり、準拠していない場合は送信できません。

重要: リクエストパラメーターのSource(メールの送信元アドレス)は、検証済みメールアドレスあるいは検証済みドメインである必要があります。

メッセージの最大サイズは2MB。(RawMessage.Dataのbase64デコード後のサイズ)

1通のメッセージにおけるTO、CC、BCCのメールアドレス合計数は最大50です。より多くのメールアドレスにメールを送信したい場合は、APIを必要なだけ実行してください。

Request Headers

「API共通リクエストヘッダー」を参照。

Request Parameter

Action

実行するAPI名。

"SendRawEmail"

Data Type	Cardinality
String	1..1

Version

APIバージョン。

"v1.0"（任意）

Data Type	Cardinality
String	0..1

Destinations.member.N

メールの送信先リスト。

省略した場合、メッセージヘッダーに設定したTO、CC、BCCのメールアドレスに送信される。

指定した場合、メッセージヘッダーに設定したTO、CC、BCCは無視され、Destinationsで設定したメールアドレスにのみ送信される。

Nは1～50まで設定可能。

Data Type	Cardinality
String	0..n

RawMessage.Data

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

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

メッセージは1つのヘッダーとボディを空行で区切ったものである必要があります。
必須のヘッダーフィールドがすべて存在する必要があります。
マルチパートMIMEメッセージの各部分を適切にフォーマットする必要があります。

Data Type	Cardinality
Blob	1..1

Source

メールの送信元アドレス。

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

ASCII以外の文字列を含む場合は、MIME形式でエンコードをする必要があります。

MIME形式でエンコードすると次の形式になります。

=? charset?エンコーディング?エンコードされたテキスト?=

詳細については、RFC 2047参照。

Data Type	Cardinality
String	0..1

Request Elements

なし

HTTPステータス

ステータス

リクエストのステータスを返却する。

以下の値を返却する。

200:: 正常終了
400:: リクエストのパラメーターエラー／アクションに失敗しメッセージが送信できなかった。
401:: 認証エラー
403:: アクセス拒否
500:: 内部エラー

Data Type	Cardinality
Int	1..1

Response Elements（正常終了時）

SendRawEmailResponse

レスポンスのエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..1	None	SendRawEmailResult ResponseMetadata

SendRawEmailResult

結果のエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..1	SendRawEmailResponse	MessageId

MessageId

メッセージを一意に特定するために生成されたメッセージID。

Data Type	Cardinality	Parent Element	Child Element(s)
xsd:string	1..1	SendEmailResult	None

ResponseMetadata

メタデータのエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..1	SendEmailResponse	RequestId

RequestId

リクエストを一意に識別するID。

問題が発生した場合の問い合わせの際にトラブルシューティングを行うために必要です。

UUID形式例：647cd254-e0d1-44a9-af61-1d6d86ea6b77

Data Type	Cardinality	Parent Element	Child Element(s)
xsd:string	1..1	ResponseMetadata	None

Example of Request


POST / HTTP/1.1
Date: Fri, 06 Jun 2014 11:00:37 GMT
Content-Length: …
Host: mail.jp-east-1.tps5.fujitsu.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8
X-Auth-Token: MIIFvgY…

Action=SendRawEmail
&RawMessage.Data=U3Viam…

Example of Response


HTTP/1.1 200 OK
Date: Fri, 06 Jun 2014 11:00:38 GMT
Content-Length: …
Content-Type: application/xml
x-fj-request-id: 0ae83209-8dd0-4392-8b15-74c693c98aad

<?xml version="1.0" encoding="UTF-8"?>
<SendRawEmailResponse>
  <SendRawEmailResult>
    <MessageId>0000012d23161b-6d55-4355-981f-1f9e835008c0-000000</MessageId>
  </SendRawEmailResult>
  <ResponseMetadata>
    <RequestId>0ae83209-8dd0-4392-8b15-74c693c98aad</RequestId>
  </ResponseMetadata>
</SendRawEmailResponse>