drewm/drip

PHP 库,用于与 Drip API 交互

v0.9 2019-01-31 10:37 UTC

This package is auto-updated.

Last update: 2024-08-29 03:36:43 UTC


README

用于向 Drip 发起基于令牌的 API 请求的 PHP 库。

Build Status Scrutinizer Code Quality

安装

要么下载并包含,要么通过 Composer 安装

composer require drewm/drip

发起简单请求

使用以下方式创建一个新的 Drip 对象

  1. 您的用户 API 令牌(设置 > 我的用户设置 > API 令牌)
  2. 您的数字账户 ID(登录 Drip 控板,它是 URL 中的第一个部分)
use DrewM\Drip\Drip;
use DrewM\Drip\Dataset;

$Drip = new Drip('abc123', '1234567')

创建新的订阅者

$data = new Dataset('subscribers', [
				'email' => 'postmaster@example.com',
			]);
$Response = $Drip->post('subscribers', $data);

列出所有订阅者

$Response = $Drip->get('subscribers');

要在 URL 中不带账户 ID 的方法中请求(例如,列出账户)

$Drip = new Drip('abc123');
$Response = $Drip->getGlobal('accounts');

然后设置账户 ID

$Drip->setAccountID('1234567');

处理响应

方法返回一个响应对象

if ($Response->status == 200) {
	// all is ok!
	$subscribers = $Response->subscribers;
} else {
	echo $Response->error;
	echo $Response->message;
}

获取原始响应

$raw = $Response->get();

Webhooks

您可以通过几种方式监听 webhooks。最基本的是

use DrewM\Drip\Drip;
$data = Drip::receiveWebhook();

如果您喜欢 pub/sub 模型,您可以注册监听器可调用

use DrewM\Drip\Drip;

Drip::subscribeToWebhook('subscriber.created', function($data){
	// A subscriber was created
});

Drip::subscribeToWebhook('subscriber.subscribed_to_campaign', function($data){
	// A subscriber was added to a campaign
});