PAGE TOP

一括登録・削除

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

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

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

HTTP(S)

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


URI /contact/import/usage
HTTP Method(s) POST
パラメータ
必須 access_token API利用許可トークン
レスポンスサンプル
【XMLの場合】
<contact>
    <success>1</success>
    <failure>1</failure>
    <details>
        <detail>
            <lineNumber>2</lineNumber>
            <content>"配信中","0","sample@blaynmail.jp"</content>
            <message>[エラー内容]</message>
        </detail>
    </details>
</contact>
    
【JSONの場合】
{"success":"1","failure":"1","details":{"detail":[{"content":"\"エラー停止\",\"3\",\"sample@blaynmail.jp\"","message":"[エラー内容]","lineNumber":2}]}}
サンプルコード
http_contact_import_usage.php
<?php

require_once 'HTTP/Request.php';

$url = 'https://api.bme.jp/rest/1.0/authenticate/login';

$request =& new HTTP_Request();
$request->setURL($url);

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('username', 'ログインID');
$request->addPostData('password', 'ログインパスワード');
$request->addPostData('api_key', '認証用トークン');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $xml = simplexml_load_string($request->getResponseBody());
}

$url = "https://api.bme.jp/rest/1.0/contact/import/usage?access_token={$xml->access_token}&type=1";

$request =& new HTTP_Request($url, array('useBrackets' => false));

$request->setMethod(HTTP_REQUEST_METHOD_GET);

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $buf = $request->getResponseBody();
    header('Content-Disposition: attachment; filename="contact_import_usage.csv"');
    header('Content-Type: application/octet-stream');
    header('Content-Transfer-Encoding: binary');
    header('Content-Length: '.strlen($buf));
    print $buf;
}

?> 

一括登録(全登録)


URI /contact/import/all
HTTP Method(s) POST
パラメータ
必須 access_token API利用許可トークン
レスポンスサンプル
【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@blaynmail.jp"</content>
            <message>[エラー内容]</message>
        </detail>
    </details>
</contact>
    
【JSONの場合】
{"success":"1","failure":"1","details":{"detail":[{"content":"\"エラー停止\",\"3\",\"sample@blaynmail.jp\"","message":"[エラー内容]","lineNumber":2}]}}
サンプルコード
http_contact_import_all.php
<?php

require_once 'HTTP/Request.php';

$url = 'https://api.bme.jp/rest/1.0/authenticate/login';

$request =& new HTTP_Request();
$request->setURL($url);

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('username', 'ログインID');
$request->addPostData('password', 'ログインパスワード');
$request->addPostData('api_key', '認証用トークン');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $xml = simplexml_load_string($request->getResponseBody());
}


$url = 'https://api.bme.jp/rest/1.0/contact/import/all';

$request =& new HTTP_Request($url, array('useBrackets' => false));

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addFile('import', './all.csv', 'Content-Type: text/plain');
$request->addPostData('access_token', $xml->access_token);

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    echo $request->getResponseBody();
}

?> 

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


URI /contact/import/create
HTTP Method(s) POST
パラメータ
必須 access_token API利用許可トークン
レスポンスサンプル
【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@blaynmail.jp"</content>
            <message>[エラー内容]</message>
        </detail>
    </details>
</contact>
    
【JSONの場合】
{"success":"1","failure":"1","details":{"detail":[{"content":"\"エラー停止\",\"3\",\"sample@blaynmail.jp\"","message":"[エラー内容]","lineNumber":2}]}}
サンプルコード
http_contact_import_create.php
<?php

require_once 'HTTP/Request.php';

$url = 'https://api.bme.jp/rest/1.0/authenticate/login';

$request =& new HTTP_Request();
$request->setURL($url);

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('username', 'ログインID');
$request->addPostData('password', 'ログインパスワード');
$request->addPostData('api_key', '認証用トークン');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $xml = simplexml_load_string($request->getResponseBody());
}


$url = 'https://api.bme.jp/rest/1.0/contact/import/create';

$request =& new HTTP_Request($url, array('useBrackets' => false));

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addFile('import', './create.csv', 'Content-Type: text/plain');
$request->addPostData('access_token', $xml->access_token);

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    echo $request->getResponseBody();
}

?> 

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


URI /contact/import/update
HTTP Method(s) POST
パラメータ
必須 access_token API利用許可トークン
レスポンスサンプル
【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@blaynmail.jp"</content>
            <message>[エラー内容]</message>
        </detail>
    </details>
</contact>
    
【JSONの場合】
{"success":"1","failure":"1","details":{"detail":[{"content":"\"エラー停止\",\"3\",\"sample@blaynmail.jp\"","message":"[エラー内容]","lineNumber":2}]}}
サンプルコード
http_contact_import_update.php
<?php

require_once 'HTTP/Request.php';

$url = 'https://api.bme.jp/rest/1.0/authenticate/login';

$request =& new HTTP_Request();
$request->setURL($url);

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('username', 'ログインID');
$request->addPostData('password', 'ログインパスワード');
$request->addPostData('api_key', '認証用トークン');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $xml = simplexml_load_string($request->getResponseBody());
}


$url = 'https://api.bme.jp/rest/1.0/contact/import/update';

$request =& new HTTP_Request($url, array('useBrackets' => false));

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addFile('import', './update.csv', 'Content-Type: text/plain');
$request->addPostData('access_token', $xml->access_token);

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    echo $request->getResponseBody();
}

?> 

一括削除


URI /contact/import/delete
HTTP Method(s) POST
パラメータ
必須 access_token API利用許可トークン
レスポンスサンプル
【XMLの場合】
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<contact>
    <success>1</success>
    <failure>1</failure>
    <details>
        <detail>
            <lineNumber>2</lineNumber>
            <content>"sample@blaynmail.jp"</content>
            <message>[エラー内容]</message>
        </detail>
    </details>
</contact>
    
【JSONの場合】
{"success":"1","failure":"1","details":{"detail":[{"content":"\"sample@blaynmail\"","message":"[エラー内容]","lineNumber":3}]}}
サンプルコード
http_contact_import_delete.php
<?php

require_once 'HTTP/Request.php';

$url = 'https://api.bme.jp/rest/1.0/authenticate/login';

$request =& new HTTP_Request();
$request->setURL($url);

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('username', 'ログインID');
$request->addPostData('password', 'ログインパスワード');
$request->addPostData('api_key', '認証用トークン');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $xml = simplexml_load_string($request->getResponseBody());
}


$url = 'https://api.bme.jp/rest/1.0/contact/import/delete';

$request =& new HTTP_Request($url, array('useBrackets' => false));

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addFile('import', './delete.csv', 'Content-Type: text/plain');
$request->addPostData('access_token', $xml->access_token);

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    echo $request->getResponseBody();
}

?> 

一括処理エラー一覧検索


URI /contact/import/error/search
HTTP Method(s) GET
パラメータ
必須 access_token API利用許可トークン
任意 format,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":"登録エラー"}]}
サンプルコード
http_contact_import_error_search.php
<?php

require_once 'HTTP/Request.php';

$url = 'https://api.bme.jp/rest/1.0/authenticate/login';

$request =& new HTTP_Request();
$request->setURL($url);

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('username', 'ログインID');
$request->addPostData('password', 'ログインパスワード');
$request->addPostData('api_key', '認証用トークン');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $xml = simplexml_load_string($request->getResponseBody());
}

$url = "https://api.bme.jp/rest/1.0/contact/import/error/search?access_token={$xml->access_token}";

$request =& new HTTP_Request($url, array('useBrackets' => false));

$request->setMethod(HTTP_REQUEST_METHOD_GET);

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    echo $request->getResponseBody();
}

?> 

一括処理エラーCSV取得


URI /contact/import/error/export
HTTP Method(s) GET
パラメータ
必須 access_token API利用許可トークン
type 「登録エラー」または「削除エラー」
date 日時(ISO 8601:yyyyMMddTHH:mm:ss)を指定
任意 format,f レスポンス形式を指定する。「xml」または「json」
レスポンスサンプル
*CSVファイルが返されます
サンプルコード
http_contact_import_error_export.php
<?php

require_once 'HTTP/Request.php';

$url = 'https://api.bme.jp/rest/1.0/authenticate/login';

$request =& new HTTP_Request();
$request->setURL($url);

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('username', 'ログインID');
$request->addPostData('password', 'ログインパスワード');
$request->addPostData('api_key', '認証用トークン');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $xml = simplexml_load_string($request->getResponseBody());
}

$url = "https://api.bme.jp/rest/1.0/contact/import/error/export?access_token={$xml->access_token}&type=" . urlencode('削除エラー') . "&date=" . urlencode('20120312T22:28:54');

$request =& new HTTP_Request($url, array('useBrackets' => false));

$request->setMethod(HTTP_REQUEST_METHOD_GET);

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $buf = $request->getResponseBody();
    header('Content-Disposition: attachment; filename="sample.csv"');
    header('Content-Type: application/octet-stream');
    header('Content-Transfer-Encoding: binary');
    header('Content-Length: '.strlen($buf));
    print $buf;
}

?> 

一括処理エラー情報削除


URI /contact/import/error/delete
HTTP Method(s) POST
パラメータ
必須 access_token API利用許可トークン
任意 format,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" ?>
<contact>
    <success>20120312T22:28:54</success>
    <failure />
</contact>
    
【JSONの場合】
{"contact":[{"date":"20120312T22:28:54"}]}
サンプルコード
http_contact_import_error_delete.php
<?php

require_once 'HTTP/Request.php';

$url = 'https://api.bme.jp/rest/1.0/authenticate/login';

$request =& new HTTP_Request();
$request->setURL($url);

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('username', 'ログインID');
$request->addPostData('password', 'ログインパスワード');
$request->addPostData('api_key', '認証用トークン');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    $xml = simplexml_load_string($request->getResponseBody());
}

$url = "https://api.bme.jp/rest/1.0/contact/import/error/delete";

$request =& new HTTP_Request($url, array('useBrackets' => false));

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('access_token', $xml->access_token);
$request->addPostData('deleteErrors', '20120312T22:28:54');

$result = $request->sendRequest();
if (!PEAR::isError($result)) {
    echo $request->getResponseBody();
}

?>