What is OAuth?¶

OAuth (Open Authorization) is a standard protocol that allows users to grant third-party applications limited access to their data without sharing their login credentials. It enhances security by enabling resource owners (users) to authorize client applications to access their information stored on resource servers through an authorization server that issues access tokens. OAuth 2.0, the most widely used version, offers improved flexibility and security, making it a critical component for secure data sharing and integration in modern web applications.

How Pointr Products Use OAuth?¶

1. Pointr Cloud Dashboard

   

2. Pointr Mobile SDK

   

3. Pointr Web SDK

   

4. Pointr REST API

   

5. Refresh Token

   

JSON Samples¶

1. Pointr Cloud Dashboard

   • Example Payload For Password:

   {
       "username": "devuser@pointr.tech",
       "Password": "yourSecretPassword",
       "Grant_type": "password"
   }
   

   • Example Success Response For Password:

   {
       "endpoint": "/api/v8/auth/token",
       "createdTimestampUtcEpochSeconds": 1718004040,
       "result": {
           "access_token": "{access-token-comes-here}",
           "token_type": "Bearer",
           "refresh_token": "Bc8hzWd7PVRToQAnOufYSO3EOlMkZkiIlFcYJPBxmTlDloMTbmooZRhc34eVVHuX0iEH0WslYkuU6RZBTY6y6Q==",
           "expires_in": 7200
       }
   }
   

2. Web SDK and Mobile SDK

   • Example Payload For Client_Credentials:

   {
       "client_id": "clientInternalIdentifier",
       "client_secret": "licenseKey",
       "grant_type":"client_credentials"
   }
   

   • Example Success Response For Client_Credentials:

   {
       "endpoint": "/api/v8/auth/token",
       "createdTimestampUtcEpochSeconds": 1718004284,
       "result": {
           "access_token": "{access-token-comes-here}",
           "token_type": "Bearer",
           "sas_token": "{sas-token-comes-here}",
           "content_base_url": "https://pointrpublishedcontentcdn.azureedge.net/"
       }
   }
   

3. Authorization Code

   • Example Payload For Authorization_Code:

   {
       "code":"0.AXkAalgMLNwmXUipF866yWI6GiHcP3FZsH5HvJR7SrMe2XgMAZg.AgABBAIAAADnfolhJpSnRYB1SVj-Hgd8AgDs_wUA9P8hVLrjK_UbwhqJfp-4IR6w6RoglLOmhKY6nIPX18XZzV2DzRUQ1tlqcuUeXDFgEzLhCiwPyDrCu0bwXTwRriHgKeXdChI7B4wwtT7C-eFa5raQ2wueN7RljMt1QbeoWRc0NrZ42u5ge-XK6vtbVTgdgYmeaky9slPfrZMvAxXrxwd5WDg525D5JhmWCkNAcnvRXsYVfFIAc8wyRqgBkpD9oTy2VHv7f7ELM_7K4yj8Vb7uV8WtTgR6hhsJheIlO0GoN_7bzs_ui3eefDpMFTXXUM1cVrd09GsUwoHNTfgC1wTAh7pB9GInTPluMhzfdYRs5gJ80l9BuWTWYS7JZ-hR0...",
       "grant_type":"authorization_code"
   }
   

   • Example Success Response For Authorization_Code:

   {
       "endpoint": "/api/v8/auth/token",
       "createdTimestampUtcEpochSeconds": 1718004040,
       "result": {
           "access_token": "{access-token-comes-here}",
           "token_type": "Bearer",
           "refresh_token": "Bc8hzWd7PVRToQAnOufYSO3EOlMkZkiIlFcYJPBxmTlDloMTbmooZRhc34eVVHuX0iEH0WslYkuU6RZBTY6y6Q==",
           "expires_in": 7200
       }
   }
   

4. Token Exchange

   • Example Payload For Token_Exchange:

   {
       "access_token": "{access-token-comes-here}",
       "grant_type":"token_exchange"
   }
   

   • Example Success Response For Token_Exchange:

   {
       "endpoint": "/api/v8/auth/token",
       "createdTimestampUtcEpochSeconds": 1718005635,
       "result": {
           "access_token": "{access-token-comes-here}",
           "token_type": "Bearer",
           "refresh_token": "fhqKbP31BtlN03Cn0imqt+2FH0UW0f2WOWnuGM+0Ev3nNBFkmIdJzNXlwhT1yp63iqtxs8uGh+vbgot6qIoPLQ==",
           "expires_in": 7200
       }
   }