Bureaucrats, editor, Administrators
470
edits
Changes
Jump to navigation
Jump to search
no edit summary
{{Api_Method_Spec|
Description=This method allows the applications to retrieve the Aura Token information, required to establish the communication with Aura backend. This method requires an authenticated token, and returns reads the AURA_API_KEY_DEVICE_TYPES parameter for the Aura ID associated with device type calling and performs a GET request to the AURA_TOKEN_URL parameter, passing the DeviceId api key in the token (from GVP_USERS_AUTH_TOKENS table)authorization header. If no Aura Id is found associated with the DeviceId, it triggers the JWT Bearer based authentication process and as It returns a result, it returns JSON containing al the AuraId information retrieved or an error codefrom the Aura token service.
|Parameters=
|Returns=
Returns a JSON object containing the Aura IDtoken information
'''Example:'''
{
"conversationId": "AXCifkJXwYkEjDkxWgA4gw",
"token": "ew0KICAiYWxnIjogIlJTMjU2IiwNCiAgImtpZCI6ICJBT08tZXhGd2puR3lDTEJhOTgwVkxOME1tUTgiLA0KICAieDV0IjogIkFPTy1leEZ3am5HeUNMQmE5ODBWTE4wTW1ROCIsDQogICJ0eXAiOi iSldUIg0KfQew0KICAiYWxnIjogIlJTMjU2IiwNCiAgImtpZCI6ICJBT08tZXhGd2puR3lDTEJhOTgwVkxOME1tUTgiLA0KICAieDV0IjogIkFPTy1leEZ3am5HeUNMQmE5ODBWTE4wTW1ROCIsDQogICJ0eXAiOiiSldUIg0KfQ.ew0KICAiYm90IjogIkJPVC1hdXJhLWFwLWN1cnJlbnQiLA0KICAic2l0ZSI6ICItb1ZZOXU3OWU5TSIsDQogICJjb252IjogIkFYQ2lma0pYd1lrRWpEa3hXZ0E0Z3ctYSIsDQogICJuYmYiOiAxNTgwODAzNzIzLA0KICAiZXhwIjogMTU4MDgwNzMyMywNCiAgImlzcyI6ICJodHRwczovL2RpcmVjdGxpbmUuYm90ZnJhbWV3b3JrLmNvbS8iLA0KICAiYXVkIjogImh0dHBzOi8vZGlyZWN0bGluZS5ib3RmcmFtZXdvcmsuY29tLyINCn0.NIQfSRXW_EoRGkRDIuHoo87Jf0CD5QF4l5xu8lnPBc2Te4ttTBpdBtEXXZqqO035ChBcRtFi3G6v3DQNJ6K37BP0fW0HFvC5ZjsE9aDfYhjRT4DQprbgDspwlVL4hmIiu_ghdcp0eXN7PUbhp4sNEbQn3j6l0Ujuxh9c3Y2BHbPC2zyr9gUMDYzfYRRwVaIeKVpRu0-44sP_Zhg6WuycBQvkJjfWAdT4c_K_StJ4zbravMFX6VIVV_kVKfQu_4_YNRMMiG93rY0awXjyD_SA NIQfSRXW_EoRGkRDIuHoo87Jf0CD5QF4l5xu8lnPBc2Te4ttTBpdBtEXXZqqO035ChBcRtFi3G6v3DQNJ6K37BP0fW0HFvC5ZjsE9aDfYhjRT4DQprbgDspwlVL4hmIiu_ghdcp0eXN7PUbhp4sNEbQn3j6l0Ujuxh9c3Y2BHbPC2zyr9gUMDYzfYRRwVaIeKVpRu044sP_Zhg6WuycBQvkJjfWAdT4c_K_StJ4zbravMFX6VIVV_kVKfQu_4_YNRMMi93rY0awXjyD_SA JW1ux8QEOsFS4S4MddOtERNh1ZloSd9ynEo5NMWlNxfvNJxql3RtUQKARZyFMGTGg",
"expires_in": 3600,
"streamUrl": "wss://directline.botframework.com/v3/directline/conversations/AXCifkJXwYkEjDkxWgA4gw-a/stream?watermark=-&t=ew0KICAiYWxnIjogIlJTMjU2IiwNCiAgImtpZCI6ICJBT08tZXhGd2puR3lDTEJhOTgwVkxOME1tUTgiLA0KICAieDV0IjogIkFPTy1leEZ3am5HeUNMQmE5ODBWTE4wTW1ROCIsDQogICJ0eXAiOiA iSldUIg0KfQew0KICAiYWxnIjogIlJTMjU2IiwNCiAgImtpZCI6ICJBT08tZXhGd2puR3lDTEJhOTgwVkxOME1tUTgiLA0KICAieDV0IjogIkFPTy1leEZ3am5HeUNMQmE5ODBWTE4wTW1ROCIsDQgICJ0eXAiOiAiSldUIg0KfQ.ew0KICAiYm90IjogIkJPVC1hdXJhLWFwLWN1cnJlbnQiLA0KICAic2l0ZSI6ICItb1ZZOXU3OWU5TSIsDQogICJjb252IjogIkFYQ2lma0pYd1lrRWpEa3hXZ0E0Z3ctYSIsDQogICJuYmYiOiAxNTgwODAzNzIzLA0KICAiZXhwIjogMTU4MDgwMzc4MywNCiAgImlzcyI6ICJodHRwczovL2RpcmVjdGxpbmUuYm90ZnJhbWV3b3JrLmNvbS8iLA0KICAiYXVkIjogImh0dHBzOi8vZGlyZWN0bGlu ew0KICAiYm90IjogIkJPVC1hdXJhLWFwLWN1cnJlbnQiLA0KICAic2l0ZSI6ICItb1ZZOXU3OWU5TSIsDQogICJjb252IjogIkFYQ2lma0pYd1lrRWpEa3hXZ0E0Z3ctSIsDQogICJuYmYiOiAxNTgwODAzNzIzLA0KICAiZXhwIjogMTU4MDgwMzc4MywNCiAgImlzcyI6ICJodHRwczovL2RpcmVjdGxpbmUuYm90ZnJhbWV3b3JrLmNvbS8iLA0KICAiYXVkIjogImh0dHBzO8vZGlyZWN0bGlu ZS5ib3RmcmFtZXdvcmsuY29tLyINCn0.FLdLsO-9Q--ZOiJzU-",
"referenceGrammarId": "4fcf85f0-4838-b45f-8290-6619774f88a8"
}
|Exceptions=
* AuthenticationRequired: 30. Returned when the method is called without a valid authenticated token
* FourthPlatformNotAvailableAuraEndpointNotAvailable: 320318. Returned when the 4P endpoints are not available or returned Aura endpoint returns 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 or is an error in the generation of the JWT Bearer token (invalid private key)not available
