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 |