Tulip API client

![Scrutinizer Code Quality][ico-quality] ![Build Status][ico-build] [ Code Coverage ][link-coverage], _(*1)

PHP client library for communicating with the Tulip API., _(*2)

Installation using Composer

Run the following command to add the package to the composer.json of your project:, _(*3)

``` bash $ composer require connectholland/tulip-api-client, _(*4)


#### Versioning
This library uses [Semantic Versioning 2](http://semver.org/) for new versions.

## Usage

Below are some common usage examples for the API client. For more information, please see the Tulip API documentation that is supplied when you want to integrate with the Tulip CRM software.

```php
<?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));

Inserting an object

<?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',
));

Updating an object

<?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',
));

Uploading a file when inserting / updating an object

<?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'),
    )
);