POST /oauth/token provider authorization code
From Social ID Developers
Revision as of 16:58, 30 December 2021 by Gabriel.prado (Talk | contribs)
Contents |
Description
Generates a new Login User Token given an OAuth2 authorization code issued by an external provider.
Resource URL
POST https://api.socialidnow.com/v2/marketing/oauth/token
Parameters
Form Url Encoded Parameters
grant_type | required | grant_type. Must be set to provider_authorization_code. |
---|---|---|
provider | required | external provider. Only gplus supported for now. |
authorization_code | required | provider authorization code. |
Authentication
This API requires Login App Client authentication. See Authentication.
Response
Response Status
ok (200) | The access token was generated successfully |
---|---|
bad_request (400) | Some required parameter was not informed. |
unauthorized (401) | The authentication is wrong. See Authentication. |
internal_server_error (500) | An unknown error happened. |
In case of error, one of of the following codes will be set in the JSON response. An error description will also be set accordingly.
Code | Description |
---|---|
invalid_client | The request authentication is invalid (not given or combination do not match); or the client authentication is invalid. |
invalid_request | A required parameter was not informed (grant_type, provider, authorization_code); or the informed provider is invalid. |
unsupported_grant_type | The informed grant type is not supported. |
Response Body
access_token | The generated access token. |
---|---|
expires_in | Expiration in seconds. |
token_type | The token_type. Will be set to bearer. |
refresh_token | The refresh_token to retrieve a new access token after expiration. |
Examples
Using Gplus provider
Request
curl -iX POST 'https://api.socialidnow.com/v2/marketing/oauth/token' \ -d grant_type=provider_authorization_code&provider=gplus&authorization_code=4/6ABnQxy8CZiZ4BNOR-uYgHM4z46P-NqAySilXGPD4tQswp6zmO4wr8FilusdIj4NtANlZeMb3pyol2dtcRyRm2g \ --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf
Response
Response Headers
HTTP/1.1 200 Ok Status: 200
Response Body
{ "access_token": "6814cd360205e1245d2834ffab3c3c9103b71a5075a9cda4626b4d5cffbabb88", "expires_in": 604800, "token_type": "bearer", "refresh_token": "17ef19c3e1b7499eaf849d59f220250210b5c44c10c71033d253de8b61b2a3ef", }