API連携

API機能一覧

一括登録・削除

指定フォーマットのCSV形式データから読者データの一括登録・削除処理を行います。
登録方法は全登録・新規登録のみ・アップデートのみ、の3種類で行い
成功数・失敗数・失敗詳細情報がそれぞれ返ります。

削除方法はデータ削除、のみから行われ、成功数・失敗数・失敗詳細情報が返ります。
尚、登録削除でも指定フォーマットのCSVのダウンロードが必要です。

CSVで日付型をご利用いただく場合は、半角数字を続けてご入力ください。
例)2013年1月1日 → 20130101

HTTP(S)

https://api.bme.jp/rest/1.0/

登録・削除用CSVデータ取得

URL /contact/import/usage
HTTP Method(s) GET

パラメータ

必須 access_token API利用許可トークン
type CSV形式(1:登録用, 2:削除用)

レスポンスサンプル

※CSVファイルが返されます

一括登録(全登録)

URL /contact/import/all
HTTP Method(s) POST

パラメータ

必須 access_token API利用許可トークン
file 一括登録CSVファイルを指定する。
任意 format レスポンス形式を指定する。「xml」または「json」

レスポンスサンプル

【XMLの場合】

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<contact>
<success>1</success>
<failure>1</failure>
<details>
<detail>
<lineNumber>2</lineNumber>
<content>"配信中","0","sample@blastmail.jp"</content>
<message>[エラー内容]</message>
</detail>
</details>
</contact>

【JSONの場合】

{"success":"1","failure":"1","details":{"detail":[{"content":"\"エラー停止\",\"3\",\"sample@blastmail.jp\"","message":"[エラー内容]","lineNumber":2}]}}

一括登録(新規登録のみ)

URL /contact/import/create
HTTP Method(s) POST

パラメータ

必須 access_token API利用許可トークン
file 一括登録CSVファイルを指定する。
任意 format レスポンス形式を指定する。「xml」または「json」

レスポンスサンプル

【XMLの場合】

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<contact>
<success>1</success>
<failure>1</failure>
<details>
<detail>
<lineNumber>2</lineNumber>
<content>"配信中","0","sample@blastmail.jp"</content>
<message>[エラー内容]</message>
</detail>
</details>
</contact>

【JSONの場合】

{"success":"1","failure":"1","details":{"detail":[{"content":"\"エラー停止\",\"3\",\"sample@blastmail.jp\"","message":"[エラー内容]","lineNumber":2}]}}

一括登録(アップデートのみ)

URL /contact/import/update
HTTP Method(s) POST

パラメータ

必須 access_token API利用許可トークン
file 一括登録CSVファイルを指定する。
任意 format レスポンス形式を指定する。「xml」または「json」

レスポンスサンプル

【XMLの場合】

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<contact>
<success>1</success>
<failure>1</failure>
<details>
<detail>
<lineNumber>2</lineNumber>
<content>"配信中","0","sample@blastmail.jp"</content>
<message>[エラー内容]</message>
</detail>
</details>
</contact>

【JSONの場合】

{"success":"1","failure":"1","details":{"detail":[{"content":"\"エラー停止\",\"3\",\"sample@blastmail.jp\"","message":"[エラー内容]","lineNumber":2}]}}

一括削除

URL /contact/import/delete
HTTP Method(s) POST

パラメータ

必須 access_token API利用許可トークン
file 一括削除CSVファイルを指定する。
任意 format レスポンス形式を指定する。「xml」または「json」

レスポンスサンプル

【XMLの場合】

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<contact>
<success>1</success>
<failure>1</failure>
<details>
<detail>
<lineNumber>2</lineNumber>
<content>"sample@blastmail.jp"</content>
<message>[エラー内容]</message>
</detail>
</details>
</contact>

【JSONの場合】

{"success":"1","failure":"1","details":{"detail":[{"content":"\"sample@blastmail\"","message":"[エラー内容]","lineNumber":3}]}}

一括処理エラー一覧検索

URL /contact/import/error/search
HTTP Method(s) GET

パラメータ

必須 access_token API利用許可トークン
任意 f レスポンス形式を指定する。「xml」または「json」
createErrors 登録エラー。
日時(ISO 8601:yyyyMMddTHH:mm:ss)を指定
deleteErrors 削除エラー。
日時(ISO 8601:yyyyMMddTHH:mm:ss)を指定

レスポンスサンプル

【XMLの場合】

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<contacts>
<contact>
<type>登録エラー</type>
<date>20120312T22:28:54</date>
<count>1</count>
</contact>
</contacts>

【JSONの場合】

{"contact":[{"count":1,"date":"20120312T22:28:54","type":"登録エラー"}]}

一括処理エラーCSV取得

URL /contact/import/error/export
HTTP Method(s) GET

パラメータ

必須 access_token API利用許可トークン
type 「登録エラー」または「削除エラー」
date 日時(ISO 8601:yyyyMMddTHH:mm:ss)を指定

レスポンスサンプル

※CSVファイルが返されます

一括処理エラー情報削除

URL /contact/import/error/delete
HTTP Method(s) POST

パラメータ

必須 access_token API利用許可トークン
任意 format レスポンス形式を指定する。「xml」または「json」
createErrors 登録エラー。
日時(ISO 8601:yyyyMMddTHH:mm:ss)を指定
deleteErrors 削除エラー。
日時(ISO 8601:yyyyMMddTHH:mm:ss)を指定

レスポンスサンプル

【XMLの場合】

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<contact>
<success>20120312T22:28:54</success>
<failure />
</contact>

【JSONの場合】

{"failure": "","success": "20180509T15:01:31"}