下書き
下書きの作成・検索を行います。登録を行うと、識別IDが返ります。検索の際に、対象の下書きが存在しない場合には空データが返ります。
HTTP(S)
https://api.bme.jp/rest/1.0/
下書きの作成
| URL |
/message/draft/create |
| HTTP Method(s) |
POST |
パラメータ
| 必須 |
access_token |
API利用許可トークン |
|
senderID |
送信者 |
|
groupID |
宛先 |
|
subject |
件名 |
|
textPart |
本文 |
| 任意 |
format |
レスポンス形式を指定する。｢xml｣または｢json｣ |
|
htmlPart |
HTMLメール用ソースコード（string型） |
|
public |
バックナンバー公開設定(true, false) |
レスポンスサンプル
【XMLの場合】
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<message>
<messageID>1</messageID>
</message>
【JSONの場合】
下書きの検索
| URL |
/message/draft/search |
| HTTP Method(s) |
GET |
※ 管理画面から作成したhtmlメールは下書き検索の対象になりません。
パラメータ
| 必須 |
access_token |
API利用許可トークン |
| 任意 |
f |
レスポンス形式を指定する。｢xml｣または｢json｣ |
|
messageIDs |
識別IDリスト |
レスポンスサンプル
【XMLの場合】
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<messages>
<message>
<messageID>1</messageID>
<date>20120309T11:37:01</date>
<subject>件名</subject>
<group>グループ名</group>
<sender>sample@blastmail.jp</sender>
</message>
</messages>
【JSONの場合】
{"message":[{"sender":"sample@blastmail.jp","messageID":1,"subject":"件名","group":"グループ名","date":"20120309T11:37:01"}]}
| messageID |
識別ID |
| date |
登録日時 |
| subject |
件名 |
| group |
宛先 |
| sender |
送信者 |
下書きの検索(メッセージデータ)
| URL |
/message/detail/search |
| HTTP Method(s) |
GET |
※ 管理画面から作成したhtmlメールは下書き検索の対象になりません。
パラメータ
| 必須 |
access_token |
API利用許可トークン |
|
messageID |
識別ID |
| 任意 |
f |
レスポンス形式を指定する。｢xml｣または｢json｣ |
レスポンスサンプル
【XMLの場合】
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<message>
<messageID>1</messageID>
<senderID>1</senderID>
<groupID>1</groupID>
<subject>件名</subject>
<textPart><![CDATA[ 本文
]]></textPart>
<htmlPart><![CDATA[
]]></htmlPart>
<scheduleDate>20120401T07:00:00</scheduleDate>
<public>false</public>
</message>
【JSONの場合】
{"groupID":1,"messageID":1,"subject":"件名","scheduleDate":"20120401T07:00:00","senderID":1,"htmlPart":"","textPart":"本文","public":false}
| messageID |
識別ID |
| senderID |
送信者 |
| groupID |
宛先 |
| subject |
件名 |
| textPart |
本文 |
| htmlPart |
HTMLメール用データ |
| scheduleDate |
配信時刻 |
| public |
バックナンバー(true:公開する、false:公開しない) |
下書きの削除
| URL |
/message/list/delete |
| HTTP Method(s) |
POST |
パラメータ
| 必須 |
access_token |
API利用許可トークン |
|
messageIDs |
識別IDリスト |
| 任意 |
format |
レスポンス形式を指定する。｢xml｣または｢json｣ |
レスポンスサンプル
【XMLの場合】
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<message>
<success>1,2</success>
<failure>3,4</failure>
</message>
【JSONの場合】
{"failure":"3,4","success":"1,2"}