PAGE TOP

個別登録

読者データの個別登録・検索・編集を行います。登録を行うと、識別IDが返ります。
エラーが発生した場合には内容に応じて以下の値が返ります。

  • -1: パラメータ不正
  • -2: 登録上限
  • -3: アドレス重複
  •  0: 登録処理に失敗

HTTP(S)

個別登録


URI /contact/detail/create
HTTP Method(s) POST
パラメータ
必須 access_token API利用許可トークン
* 項目設計において必須としている項目を設定します
任意 format,f レスポンス形式を指定する。「xml」または「json」
* 項目設計において利用としている項目を設定します
レスポンスサンプル
【XMLの場合】
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<contact>
    <contactID>1</contactID>
</contact>
    
【JSONの場合】
{"contactID":1}
サンプルコード
http_contact_detail_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/detail/create';

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

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('access_token', $xml->access_token);
$request->addPostData('status', '配信中');
$request->addPostData('error', '0');
$request->addPostData('c15', 'sample@blaynmail.jp');

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

?> 

個別検索


URI /contact/detail/search
HTTP Method(s) GET
パラメータ
必須 access_token API利用許可トークン
contactID or email 識別ID又はE-Mail
任意 format,f レスポンス形式を指定する。「xml」または「json」
レスポンスサンプル
【XMLの場合】
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<contact>
    <contactID>1</contactID>
    <error>0</error>
    <status>配信中</status>
    <c15>sample@blaynmail.jp</c15>
</contact>
    
【JSONの場合】
{"error":"0","status":"配信中","contactID":49,"c15":"sample@blaynmail.jp"}
  • contactID
  • error
  • status
  • 識別ID
  • エラー回数
  • 状態(配信中・配信停止・解除・削除・エラー停止)
サンプルコード
http_contact_detail_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/detail/search?access_token={$xml->access_token}&email=" . urlencode('sample@blaynmail.jp');

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

$request->setMethod(HTTP_REQUEST_METHOD_GET);

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

?> 

個別編集


URI /contact/detail/update
HTTP Method(s) POST
パラメータ
必須 access_token API利用許可トークン
contactID 識別ID
任意 format,f レスポンス形式を指定する。「xml」または「json」
* 使用項目
レスポンスサンプル
【XMLの場合】
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<contact>
    <contactID>1</contactID>
</contact>
    
【JSONの場合】
{"contactID":1}
サンプルコード
http_contact_detail_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/detail/update';

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

$request->setMethod(HTTP_REQUEST_METHOD_POST);
$request->addPostData('access_token', $xml->access_token);
$request->addPostData('contactID', '1');
$request->addPostData('status', '配信中');

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

?>