dairin-kaeru/dairin-php-client

DairinのAPIを呼び出すためのPHPクライアントライブラリ

dev-main 2025-03-10 11:06 UTC

Requires

• php: >=8.1
• guzzlehttp/guzzle: ^7.2

MIT

• dairin

README

Dairin のプロジェクト操作用 API を呼び出すための PHP クライアントライブラリです。

広告主様のシステムに組み込んでご使用いただけます。

Dairin の API を PHP 以外の実行環境でご利用いただきたい場合は、本リポジトリの実装を参考にご自身の環境向けに移植してください。

インストール

Composerを利用してインストールします。

composer require dairin-kaeru/dairin-php-client

Packagist のリンク

https://packagist.org/packages/dairin-kaeru/dairin-php-client

使用例

require 'vendor/autoload.php';
use DairinClient\DairinClient;
use GuzzleHttp\Exception\BadResponseException;

$key = getenv('DAIRIN_PROJECT_API_KEY');
$secret = getenv('DAIRIN_PROJECT_API_SECRET');
$client = new DairinClient($key, $secret);
$jsonEncodeFlags = JSON_PRETTY_PRINT|JSON_UNESCAPED_UNICODE|JSON_UNESCAPED_SLASHES;

// 疎通確認
try {
    $pingResp = $client->ping();
    echo json_encode(json_decode($pingResp->getBody()), $jsonEncodeFlags);
    echo PHP_EOL;
} catch (BadResponseException $e) {
    echo json_encode(json_decode($e->getResponse()->getBody()), $jsonEncodeFlags);
    echo PHP_EOL;
    exit(1);
}

$partner_code = '<<提携コード>>';
$campaign_code = '<<キャンペーンコード>>';
$customer_uid = date('Y/m/d_H:i:s.v');

// 新規の顧客に中間CVを発生させる
try {
    $signupResp = $client->signup(
        partner_code: $partner_code,
        campaign_code: $campaign_code,
        customer_uid: $customer_uid,
    );
    echo json_encode(json_decode($signupResp->getBody()), $jsonEncodeFlags);
    echo PHP_EOL;
} catch (BadResponseException $e) {
    echo json_encode(json_decode($e->getResponse()->getBody()), $jsonEncodeFlags);
    echo PHP_EOL;
    exit(2);
}

// 既存の顧客（中間CVユーザー）に最終CVを発生させる
try {
    $completeResp = $client->complete(
        customer_uid: $customer_uid,
        campaign_code: $campaign_code,
        event_id: 'dairin-php-client から発火しました',
        //sales_amount: 1000,
    );
    echo json_encode(json_decode($completeResp->getBody()), $jsonEncodeFlags);
    echo PHP_EOL;
} catch (BadResponseException $e) {
    echo json_encode(json_decode($e->getResponse()->getBody()), $jsonEncodeFlags);
    echo PHP_EOL;
    exit(3);
}