GetAuraId

Description

This method requires an authenticated token, and returns the Aura ID associated with the DeviceId in the token (from GVP_USERS_AUTH_TOKENS table).

If no Aura Id is found associated with the DeviceId, it triggers the JWT Bearer based authentication process and as a result, it returns the AuraId retrieved or an error code.

Parameters

• token (String, required)

A valid token for identifying the API session context. The a logged token is required.

Returns

Returns a JSON object containing the Aura ID

Example:

{

"StatusCode": 0,

"Severity": 1,

"StatusMessage": "OK",

"Content": {

"Pins": "auraId": "27a59005-4591-45ae-8f37-de8656631f1e"

}

}

Exceptions

• AuthenticationRequired: 30. Returned when the method is called without a valid authenticated token
• FourthPlatformNotAvailable: 320. Returned when the 4P endpoints are not available or returned an error
• UserNotFoundInFourthPlatform : 321. Returned when the 4P User Profile search for the user UNIQUE ID doesn't return any results
• AuraBearerGenerationException : 322. Returned when there is an error in the generation of the JWT Bearer token (invalid private key)

Caching

This method is not cached.

Known issues

• None

Version history

API Version Number	Change description	Changes author
8.3	Initial method design	Francisco Milagro