To setup your project, follow these steps:
- Install the package via Composer:
composer require niland/api-client-php
- Next you'll have to initialize the client with your API-Key. You can find it on your Niland API account.
// composer autoload
require __DIR__ . '/vendor/autoload.php';
$client = new \NilandApi\Client(YOUR_API_KEY);
List tracks using pagination
$response = $client->get('tracks', array('page_size' => 10, 'page' => 2));
Retrieve a track by its reference
$response = $client->get('tracks/reference/YOUR_REFERENCE');
Find tracks by similarity and/or tags
$response = $client->get('tracks/search', array(
'similar_ids' => array(1234),
'tag_ids' => array(21, 41)
));
Post a track
$response = $client->post('tracks', array(
'title' => 'foobar',
'artist' => 'foobar',
'reference' => 'foobar',
'tags' => array(21, 41),
'audio' => fopen('/path/to/your/audio/file.mp3', 'r')
));
You will get a 400 Bad Request
if you use a URL in fopen
with PHP 7. It generate an invalid chunk body error.
The following exemple will generate a 400:
$response = $client->post('tracks', array(
'title' => 'foobar',
'artist' => 'foobar',
'reference' => 'foobar',
'tags' => array(21, 41),
'audio' => fopen('http://myawesomewebsite.com/file.mp3', 'r')
));