Generate a token

Generate a token

POST https://api.complycube.com/v1/tokens

Generates an SDK token.

Headers

Name	Type	Description
Content-Type	string	The content-type must always be set to application/json.
Authorization	string	The API live or test key

Request Body

Name	Type	Description
clientId	string	The ID of the client.
referrer	string	The referrer URI pattern for the Web SDK. You can find more details below.

200 SDK token successfully generated.

{
    "token": "<CLIENT_TOKEN>"
}

400 An example of a Bad Request response, when an invalid clientId is provided.

{
    "type": "invalid_request",
    "message": "'clientId' is invalid",
    "param": "clientId"
}

The referrer attribute

The referrer attributes specify the URI of the web page where you will use the Web SDK. The referrer sent by the browser must match the referrer URI pattern in the JWT for the SDK to successfully authenticate.

The referrer is based on the Google Chrome match pattern URIs. URIs can contain wild card characters.

The referrer pattern included in the JWT guarantees that other malicious websites cannot reuse the JWT if it is lost.

Example request

cURL

curl -X POST https://api.complycube.com/v1/tokens \
     -H 'Authorization: <YOUR_API_KEY>' \
     -H 'Content-Type: application/json' \
     -d '{
          	"clientId":"CLIENT_ID",
          	"referrer": "https://www.example.com/*"
        }'

Node.js

const { ComplyCube } = require("@complycube/api");

const complycube = new ComplyCube({ apiKey: "<YOUR_API_KEY>" });

const token = await complycube.token.generate("CLIENT_ID", {
    referrer: "https://www.example.com/*"
});

Python

from complycube import ComplyCubeClient
cc_api = ComplyCubeClient(api_key='<YOUR API KEY>')

token = cc_api.tokens.create('CLIENT_ID','https://www.example.com/*')

PHP

 use ComplyCube\ComplyCubeClient;

$ccapi = new ComplyCubeClient('<YOUR API KEY>');
$report = $ccapi->tokens()->generate('CLIENT_ID', 'https://www.example.com/*');