API Reference
v1.7.3
Search…
⌃K

Generate a token

post
https://api.complycube.com
/v1/tokens
Generate a token
Generates an SDK token.
Parameters
Header
Content-Type*
string
The content-type must always be set to application/json.
Authorization*
string
The API live or test key
Body
clientId*
string
The ID of the client.
referrer
string
The referrer URI pattern for the Web SDK. You can find more details below. This is required for the Web SDK.
appId
string
The iOS or Android application or bundle ID. This is required for the Mobile SDKs.
Responses
200
SDK token successfully generated.
400
An example of a Bad Request response, when an invalid clientId is provided.

The referrer attribute

The referrer attribute specifies 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 authenticate successfully.
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 for Web SDK

cURL
Node.js
Python
PHP
.NET
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/*"
}'
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/*"
});
from complycube import ComplyCubeClient
cc_api = ComplyCubeClient(api_key='<YOUR_API_KEY>')
token = cc_api.tokens.create('CLIENT_ID','https://www.example.com/*')
use ComplyCube\ComplyCubeClient;
$ccapi = new ComplyCubeClient('<YOUR_API_KEY>');
$token = $ccapi->tokens()->generate('CLIENT_ID', 'https://www.example.com/*');
using ComplyCube.Net;
using ComplyCube.Net.Resources.SDKTokens;
var sdkTokenApi = new SDKTokenApi(new ComplyCubeClient("<YOUR_API_KEY>"));
var sdkTokenRequest = { clientId = "CLIENT_ID" ,
referrer = "https://www.example.com/*" }
var sdkToken = await sdkTokenApi.GenerateToken(sdkTokenRequest);

Example request for Mobile SDK

cURL
Node.js
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/*"
}'
const { ComplyCube } = require("@complycube/api");
const complycube = new ComplyCube({ apiKey: "<YOUR_API_KEY>" });
const token = await complycube.token.generate("CLIENT_ID", {
appId: "com.myapp.demo.app"
});