These docs are for v2.0. Click to read the latest docs for v2.1.

registerConcurrentAccess

Method for registering the device identifier in order to limit concurrent access from multiple devices. The provided identifier is added to the pool of identifiers and is kept in the pool for 3 hours. The current limit of identifiers in the pool is 4.

Parameters

NameTypeDescription
publisherToken* stringYou can find your publisher token on the api-keys page.
customerToken* stringThe token that identifies the customer, read more here .
deviceId* stringA unique deviceId. It can be an IP address. To prevent using the content from too many devices, there's a limit of 4 device identifiers per user. A single device is marked by used for 3 hours. That means that if the user used too many devices and an ID was blacklisted, after 3 hours, it will be available again if some other IDs expire.
contentGroupstringA unique content group identifier.

For each content group, there will be created separate device identifiers pool.

If the parameter is not provided, the global devices pool is used.

Result Parameters

NameTypeDescription
successbooleantrue/false information about registration success

API Request/Response

Request

{
  "method": "registerConcurrentAccess",
  "params": {
    "publisherToken": "CybqkiTFp4gTKYvuBImBXzn86yMo8VY4fyZNdl-CfFhxGDw9",
    "customerToken" : "Ilrx-SjTLVMCsaRsOf2q2hvWKOlrF57yHknDRRRMX-13Fz-x",
    "deviceId": "example1",
    "contentGroup": "example"
  },
  "jsonrpc": "2.0",
  "id": 1
}

Response

{
  "result": {
    "success": true
  },
  "id": "1",
  "jsonrpc": "2.0"
}

Error Codes

CodeDescription
3Invalid publisher token
1Invalid customer token