Overview

API Docs (1.0.0)

Servers and Resources

LP (Licensing Platform) - https://music.clicknclear.com
LVS (License Verification System) - https://verification.clicknclear.com
Support Email - support@clicknclear.com
Tech Team Email - techteam@clicknclear.com

API Keys

To create an API key please make sure you first contact a ClicknClear admin so they can enable API Key support for your user account.

Api Key Setup

• Navigate to https://music.clicknclear.com/profile (login if you are not)

• If your account is setup correctly you should have an “API Keys” section. If you cannot see this section please get in contact via the support email or the Tech Team email.

• Click on the “Create API Key” button

• Enter a name for the API Key, this is to help you identify it at a later date

• Copy the API Key ID and the API Key Secret and store them somewhere safe, you will not be able to view the Key Secret again.

• To use the postman collection, copy the API Key ID and the API Key Secret into the relevant postman environment variables.

Authentication

See the Login routes for more information on how to get Access Tokens and Refresh Tokens.
There is a Postman script on the Login route that will automatically add the access and refresh tokens to your postman environment.
To authenticate your requests to the ClicknClear API add the access token to the “Authorization” header with the value of “Bearer {ACCESS_TOKEN}”.

EG:

'Authorization': 'Bearer XXXXX'

Server Responses

Throughout our APIs we heavily utilise HTTP Codes to signify the status of the request. In general, a 4xx status code will have the error type and usually a message to help the developer know why the request failed. Below is an example of an erroneous login request.

{
    "statusCode": 400,
    "error": "Bad Request",
    "message": "[\n  {\n    \"code\": \"invalid_type\",\n    \"expected\": \"string\",\n    \"received\": \"undefined\",\n    \"path\": [\n      \"apiKey\"\n    ],\n    \"message\": \"Required\"\n  }\n]"
}

If you are consistently receiving 400s or even 500s and you’re not sure how to fix it please email the Tech Team email with steps to reproduce your issue.

• OpenAPI version: 3.0.0

Authentication

noauthAuth

Security scheme type: http

bearerAuth

Security scheme type: http