getAppServices

POST public/getAppServices

Returns the SC//AcuVigil mobile app services your account can use. Every user gets viewer. Users who can activate ESDs also get installer.

Request syntax

curl https://apiv2.acumera.net/public/getAppServices \
  --cookie av_session.txt

The username, password, and tfa_token parameters are also accepted, and are required only if the client hasn't already signed in with login. See Getting started with the SC//AcuVigil API.

Request parameters

This function takes no parameters of its own.

Response syntax

{
    "success": "string",
    "data": {
        "available_services": [
            "string"
        ]
    }
}

Response parameters

If the call succeeds, success is "1" and the following data is returned.

Field Description
available_services The services your account can use: viewer for every user, plus installer if your account can activate ESDs.

Errors

If the call fails, success is "0", and returnCode and returnMessage describe the problem. The HTTP status is still 200.

Return code Message Cause
INVALID_LOGIN We were unable to log you in. Make sure you entered the correct username, password and 2FA code. You haven't signed in, your session has ended, or the credentials sent with the call are wrong.

Examples

Example: Get the services for an account that can activate ESDs

curl https://apiv2.acumera.net/public/getAppServices \
  --cookie av_session.txt

Response:

{
    "success": "1",
    "data": {
        "available_services": ["viewer", "installer"]
    }
}

An account that can't activate ESDs gets ["viewer"].