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

Name

Type

Description

publisherToken*

string

You can find your publisher token on the api-keys page.

customerToken*

string

The token that identifies the customer, read more here .

deviceId*

string

A 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.

contentGroup

string

A 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

Name

Type

Description

success

boolean

true/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

Code

Description

3

Invalid publisher token

1

Invalid customer token