README

用于与 Tulip API 通信的 PHP 客户端库。

使用 Composer 进行安装

运行以下命令将包添加到您的项目 composer.json 文件中

$ composer require connectholland/tulip-api-client

版本控制

此库使用 语义版本控制 2 进行新版本。

使用方法

以下是 API 客户端的一些常见使用示例。如需更多信息，请参阅 Tulip API 文档，该文档在您希望与 Tulip CRM 软件集成时提供。

<?php

$client = new ConnectHolland\TulipAPI\Client('https://api.example.com', '1.1');

// Calls https://api.example.com/api/1.1/contact/detail with id=1
$response = $client->callService('contact', 'detail', array('id' => 1));

插入对象

<?php

$client = new ConnectHolland\TulipAPI\Client('https://api.example.com', '1.1');

// Calls https://api.example.com/api/1.1/contact/save
$response = $client->callService('contact', 'save', array(
    'firstname' => 'John',
    'lastname' => 'Doe',
    'email' => 'johndoe@gmail.com',
));

更新对象

<?php

$client = new ConnectHolland\TulipAPI\Client('https://api.example.com', '1.1');

// Calls https://api.example.com/api/1.1/contact/save
$response = $client->callService('contact', 'save', array(
    'id' => 1,
    'firstname' => 'Jane',
    'lastname' => 'Doe',
    'email' => 'janedoe@gmail.com',
));

在插入/更新对象时上传文件

<?php

$client = new ConnectHolland\TulipAPI\Client('https://api.example.com', '1.1');

// Calls https://api.example.com/api/1.1/contact/save
$response = $client->callService('contact', 'save',
    array(
        'id' => 1,
        'firstname' => 'Jane',
        'lastname' => 'Doe',
        'email' => 'janedoe@gmail.com',
    ),
    array(
        'photo' => fopen('/path/to/files/photo.jpg', 'r'),
    )
);

致谢

• Niels Nijens

有关参与此项目的贡献者列表，请参阅。

许可证

此库受 MIT 许可证许可。有关详细信息，请参阅LICENSE 文件。