Authentication with Buffer is the first step in building your app.
Buffer is an OAuth 2.0 provider. We recommend using one of the many great OAuth 2.0 libraries to do the heavy lifting!
All of the Buffer API endpoints require authentication. To get an access_token you must first register an application here. Once you have registered an app follow the steps below to gain authorized access to a users account.
Please note: a good OAuth library will handle most of these steps for you. You should only need to supply a client ID and secret.
First, redirect your user to the authorize endpoint. Note, the redirect_uri must match the one given when you app was registered.
GET https://bufferapp.com/oauth2/authorize? client_id=...& redirect_uri=...& response_type=code
The user will then approve or deny the request to authorize your application. At this point they will be redirected back to the redirect_uri location with an authorization code or error message as a query parameter. This should look something like:
Note: If you only need a single access token, we will automatically generate that for you after you have created an app.
Your app should swap the authorization code for an access token by POSTing it along with your client_id, client_secret, redirect_uri and grant_type=authorization_code to our token endpoint. Note, a code is valid for a limited amount of time only - this swap should be performed as soon as the code is received.
POST https://api.bufferapp.com/1/oauth2/token.json POST Data client_id=...& client_secret=...& redirect_uri=...& code=...& grant_type=authorization_code
If your request is successful we will return a long-lived access token which can be used to access the users account details for all further api requests.
All requests to the Buffer API must be made using HTTPS, with the access token provided in the HTTP Authorization header, request body or query string. For example, using the query string:
The implementation is based on version 20 of the IETF draft, available at http://tools.ietf.org/html/draft-ietf-oauth-v2-20.