作成したメールメッセージの送信 (POST /)

入力データを基にして作成されたメールメッセージを送信します。

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

メッセージの最大サイズは2MB。(Message.Body.Text.DataとMessage.Body.Html.Dataのデータ合計)

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

Request Headers

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

Request Parameter

Action

実行するAPI名。

"SendEmail"

Data Type	Cardinality
String	1..1

Version

APIバージョン。

"v1.0"（任意）

Data Type	Cardinality
String	0..1

Destination.ToAddresses.member.N

送信先To。

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

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

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

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

Data Type	Cardinality
String	0..n（Destinationは必須項目）

Destination.CcAddresses.member.N

送信先Cc。

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

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

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

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

Data Type	Cardinality
String	0..n（Destinationは必須項目）

Destination.BccAddresses.member.N

送信先Bcc。

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

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

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

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

Data Type	Cardinality
String	0..n（Destinationは必須項目）

Message.Subject.Data

メール件名のデータ。

Data Type	Cardinality
String	0..1（Messageは必須項目）

Message.Subject.Charset

メール件名の文字コード。

Data Type	Cardinality
String	0..1（Messageは必須項目）

Message.Body.Text.Data

メール本文のテキストデータ。

Data Type	Cardinality
String	0..1（Messageは必須項目）

Message.Body.Text.Charset

メール本文のテキストの文字コード。

Data Type	Cardinality
String	0..1（Messageは必須項目）

Message.Body.Html.Data

メール本文のHTMLデータ。

Data Type	Cardinality
String	0..1（Messageは必須項目）

Message.Body.Html.Charset

メール本文のHTMLの文字コード。

Data Type	Cardinality
String	0..1（Messageは必須項目）

ReplyToAddresses.member.N

メールの返信先リスト。

受信者がメッセージに返信した場合、それぞれの返信先アドレスに返信が届きます。

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

Data Type	Cardinality
String	0..n

ReturnPath

送信不達の際の通知(バウンスメール)を転送するアドレス。

Data Type	Cardinality
String	0..1

Source

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

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

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

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

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

Data Type	Cardinality
String	1..1

Request Elements

なし

HTTPステータス

ステータス

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

以下の値を返却する。

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

Data Type	Cardinality
Int	1..1

Response Elements（正常終了時）

SendEmailResponse

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

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

SendEmailResult

結果のエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..1	SendEmailResponse	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=SendEmail
&Destination.ToAddresses.member.1=allan%40example.com
&Message.Body.Text.Data=body
&Message.Subject.Data=subject
&Source=user%40example.com

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: baf96453-4867-4359-9cfc-5fee3afe7e98

<?xml version="1.0" encoding="UTF-8"?>
<SendEmailResponse>
  <SendEmailResult>
    <MessageId>000001fd985ba1-c92b-49ba-97ee-afcefdb6bab5-000000</MessageId>
  </SendEmailResult>
  <ResponseMetadata>
    <RequestId>baf96453-4867-4359-9cfc-5fee3afe7e98</RequestId>
  </ResponseMetadata>
</SendEmailResponse>