POST /oauth/token provider authorization code
From Social ID Developers
(Difference between revisions)
(Created page with "== Description == Generates a new Login User Token given an OAuth2 authorization code issued by an external provider. == Resource URL == POST https://api.socialidnow.com...") |
|||
(2 intermediate revisions by one user not shown) | |||
Line 18: | Line 18: | ||
! align="left" width="200px" | provider | ! align="left" width="200px" | provider | ||
| width="200px" | required | | width="200px" | required | ||
− | | external provider. | + | | external provider. Only ''gplus'' supported for now. |
|- | |- | ||
! align="left" width="200px" | authorization_code | ! align="left" width="200px" | authorization_code | ||
Line 27: | Line 27: | ||
== Authentication == | == Authentication == | ||
− | This API requires | + | This API requires Login App Client authentication. See [[Authentication]]. |
== Response == | == Response == | ||
Line 85: | Line 85: | ||
curl -iX POST 'https://api.socialidnow.com/v2/marketing/oauth/token' \ | curl -iX POST 'https://api.socialidnow.com/v2/marketing/oauth/token' \ | ||
− | grant_type=provider_authorization_code&provider=gplus&authorization_code=4/6ABnQxy8CZiZ4BNOR-uYgHM4z46P-NqAySilXGPD4tQswp6zmO4wr8FilusdIj4NtANlZeMb3pyol2dtcRyRm2g \ | + | -d grant_type=provider_authorization_code&provider=gplus&authorization_code=4/6ABnQxy8CZiZ4BNOR-uYgHM4z46P-NqAySilXGPD4tQswp6zmO4wr8FilusdIj4NtANlZeMb3pyol2dtcRyRm2g \ |
--user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf | --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf | ||
Latest revision as of 16:58, 30 December 2021
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", }