告别繁琐的APIID：如何用Composer和snowcap/emarsys优雅集成Emarsys营销平台

<code class="bash">composer require snowcap/emarsys:*</code>

<code class="php">require 'vendor/autoload.php';</code>

<code class="php">use Snowcap\Emarsys\Client;
use Snowcap\Emarsys\HttpClient\CurlClient;

// 假设你的API凭据定义为常量
define('EMARSYS_API_USERNAME', 'your_username');
define('EMARSYS_API_SECRET', 'your_secret');

$httpClient = new CurlClient();
$client = new Client($httpClient, EMARSYS_API_USERNAME, EMARSYS_API_SECRET);</code>

<code class="php">// 检索一个联系人（通过邮箱，假设邮箱字段ID为3）
$response = $client->getContact(array(3 => 'example@example.com'));
// 打印响应数据
print_r($response->getData());

// 创建一个新联系人（仅邮箱）
$response = $client->createContact(array(3 => 'new_user@example.com'));
print_r($response->getData());</code>

<code class="php">$client->addFieldsMapping(array('petName' => 7849, 'twitter' => 7850));</code>

<code class="php">// 使用字段名称创建更复杂的联系人，代码可读性大大提高！
$response = $client->createContact(array(
    'email'      => 'johndoe@gmail.com',
    'firstName'  => 'John',
    'lastName'   => 'Doe',
    'gender'     => $client->getChoiceId('gender', 'male'), // 注意这里的getChoiceId
    'birthDate'  => '2014-03-27',
    'petName'    => 'Buddy', // 使用自定义字段名
    'twitter'    => '@johndoe', // 使用自定义字段名
));
print_r($response->getData());</code>

<code class="php">$fieldId = $client->getFieldId('firstName'); // 将返回 1
$fieldName = $client->getFieldName(3);    // 将返回 'email' (如果默认映射存在)</code>

<code class="php">$client->addChoicesMapping(array('gender' => array('male' => 1, 'female' => 2)));</code>

<code class="php">$choiceId = $client->getChoiceId('gender', 'male'); // 将返回 1
$choiceName = $client->getChoiceName('gender', 1); // 将返回 'male'</code>

<code class="php">$response = $client->getContact(array(3 => 'nonexistent@example.com'));
if ($response->getReplyCode() === 10001) { // 假设10001是“联系人未找到”的错误码
    echo "联系人未找到: " . $response->getReplyText();
} else {
    print_r($response->getData());
}</code>

<code class="php">try {
    $response = $client->createContact(array('invalid_field' => 'value'));
} catch (\Snowcap\Emarsys\Exception\ServerException $e) {
    echo "Emarsys API错误: " . $e->getReplyText() . " (Code: " . $e->getReplyCode() . ")\n";
    // 例如，检查是否是联系人已存在错误，然后更新而不是创建
    if ($e->getReplyCode() === 2008) { // 假设2008是联系人已存在的错误码
        echo "联系人已存在，尝试更新...\n";
        // ... 执行更新逻辑 ...
    }
} catch (\Snowcap\Emarsys\Exception\ClientException $e) {
    echo "客户端使用错误: " . $e->getMessage() . "\n";
}</code>