No description, website, or topics provided.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Niland API PHP Wrapper


To setup your project, follow these steps:

  1. Install the package via Composer:
composer require niland/api-client-php
  1. 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);

Quick Start

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')

Known Issues

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('', 'r')