README

关于

这是ActiveCampaign API v3的非官方PHP封装。目前我们仅从联系人类别开始。

安装

推荐通过 Packagist 和 Composer 进行安装。运行以下命令以安装包并将其添加到项目中的 composer.json 文件中：

composer require papajin/activecampaign-api-php

需求

该库使用 Guzzle 库进行http调用。目前稳定的版本是 ~6.0。我们环境中使用的是PHP版本（5.6.38）（由于一些遗留代码的限制）。该包也可以与PHP版本 7.2 正常工作。尚未测试与其他PHP版本的包操作。

示例

请参考 API 文档 了解参数和响应结构。

<?php
require 'vendor/autoload.php';

use papajin\ActiveCampaign\AC\Contact;
use \GuzzleHttp\Exception\ClientException;


const AC_API_PROJECT = 'https://account.api-us1.com';
const AC_API_KEY = 'somelongstringherewithyourkey';

$ac_contact = Contact::instance( AC_API_PROJECT, AC_API_KEY );

/* OR $contact = Contact::instance(  new \GuzzleHttp\Client( $options ) ); */

$id = 7;

try {

    // Get data for contact with id 7
    $response_body = $ac_contact->show( $id );

    $contact = $response_body->contact;

    $geoIps = $response_body->geoIps; // ...and so on.
    
    // Create contact
    $data = [
        "email"     => "john_doe@gmail.com",
        "firstName" => "John",
        "lastName"  => "Doe",
    ];
    
    $response_body = $ac_contact->create( $data );

} catch ( ClientException $e ) {

    // Something wrong on the service side
    if( 404 == $e->getCode() )
        echo 'Not found exception: ' . $e->getMessage() . PHP_EOL;
    elseif ( 403 == $e->getCode() )
        echo 'Check that valid token provided: ' . $e->getMessage() . PHP_EOL;

}
catch ( RuntimeException $e ) {
 
     // Something wrong on your side
     echo 'Caught exception: ' . $e->getMessage() . PHP_EOL;
 
 }