GetAuraId

From Gvp-public
Revision as of 22:05, 15 November 2020 by Id02256 (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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": {
"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


See also