This developer portal is deprecated. The V2 API documentation and OAuth application management have moved to the new Are.na Developers site.

Authentication

Access Token

Access tokens allow apps to make requests to Arena on the behalf of a user. Each access token is unique to the user and application ID. Access tokens do not expire, but they may be revoked by the user.

There are two flows for authenticating a user and obtaining an access token: code and token, which are generally used by web and client apps, respectively.

Requesting authorization

To request the authorization token, you should redirect users to the authorize endpoint:

http://dev.are.na/oauth/authorize
   ?client_id=YOUR_CLIENT_ID
   &redirect_uri=YOUR_CALLBACK_URL
   &response_type=code 

If the user authorizes the your application they will be redirected back to

YOUR_CALLBACK_URL/?code=CODE

Requesting the access token

To request the access token, you should use the returned code and exchange it for a access token. To do that you can use any HTTP client.

POST https://dev.are.na/oauth/token
   ?client_id=THE_ID
   &client_secret=THE_SECRET
   &code=RETURNED_CODE
   &grant_type=authorization_code
   &redirect_uri=YOUR_CALLBACK_URL

Response

The response will be in JSON

{
   "access_token": "ACCESS_TOKEN",
   "token_type": "bearer",
   "expires_in": null
}

You can now make authenticated requests to the API signed with this access token.