requestAccess

Request user approval for the current application through EMOTIV Launcher.

When your application calls this method for the first time, EMOTIV Launcher displays a message to approve your application. You can call this API many times, but EMOTIV Launcher will prompt the user only once. If the user has already approved your application, then this API does nothing.

Almost all the methods of the API require that your application was approved in EMOTIV Launcher. These methods will return an error if your application wasn't approved.

Any application that connects to Cortex must call this API to request approval from the user through EMOTIV Launcher.

Most of the methods of the API will fail if the user didn't approve your application.

Parameters

Name	Type	Required	Description
clientId	string	yes	The client id of your Cortex application
clientSecret	string	yes	The client secret of your Cortex application

Result

The result is an object containing a boolean value "accessGranted" and a message.

Name	Type	Description
accessGranted	boolean	True, if the user has already approved your application False, if the user declined your application, or didn't approve it yet
message	string

If accessGranted is false, then your application should ask the user to check EMOTIV Launcher and approve your application. Then you should wait for a while and call this API again. If accessGranted is true, then no action is required.

Examples

Application was already approved

Request

{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "requestAccess",
    "params": {
        "clientId": "xxx",
        "clientSecret": "xxx"
    }
}

Response

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "accessGranted":true,
        "message":"The User has granted access right to this application."
    }
}

Application is not approved yet, or declined

Request

{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "requestAccess",
    "params": {
        "clientId": "xxx",
        "clientSecret": "xxx"
    }
}

Response

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "accessGranted":false,
        "message":"The User has not granted access right to this application. Please use Emotiv App to proceed."
    }
}