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

verifyConcurrentAccess

Method for checking if the next device is allowed to access the content in a concurrent access situation.

Parameters

NameTypeDescription
publisherToken* stringYou can find your publisher token on api-keys page.
customerToken* stringThe token that identifies the customer, read more here.
deviceId* stringA unique deviceId. It can be an IP address.
contentGroupstringA unique content group identifier in the context of which concurrent access will be verified.

If a parameter is not provided, global devices pool is verified.

Result Parameters

NameTypeDescription
allowedbooleantrue/false Information about concurrent access right
expiresAtintegerThe expiration time for access to the content. The value says when it will be possible to access content from the next concurrent device. This information can be used in the customer App to inform the user.

API Request/Response

Request

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

Response

{
  "result": {
    "expiresAt": 1622224217,
    "isAllowed": true
  },
  "id": "1",
  "jsonrpc": "2.0"
}

Error Codes

CodeDescription
3Invalid publisher token
1Invalid customer token