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
HTTP/1.1 200 Ok
Status: 200
Response Body
{
"access_token": "6814cd360205e1245d2834ffab3c3c9103b71a5075a9cda4626b4d5cffbabb88",
"expires_in": 604800,
"token_type": "bearer",
"refresh_token": "17ef19c3e1b7499eaf849d59f220250210b5c44c10c71033d253de8b61b2a3ef",
}