🔏
API Docs
  • Beam API Docs
  • Overview
    • About Beam
    • API Requirements
    • Roles and Permissions
  • Getting Started
    • Requesting an Account
    • Using RESTful Tools
    • Webhooks
  • The Basics
    • Entities
    • Best Practices
    • Testing Accounts
  • OAuth
    • Overview
    • How to Authorize Access
      • Step 1: Generate Authorization URL
      • Step 2: Handle Authorization Response
      • Step 3: Request an Access Token
      • Step 4: Call API Endpoints
      • Step 5: Refresh the Tokens
  • API Endpoints
    • Overview
    • Get User Devices
    • Toggle Door
    • Invite User (internal)
    • Get Toggle History
    • Get User Info
    • Get User Settings
Powered by GitBook
On this page
  1. OAuth
  2. How to Authorize Access

Step 3: Request an Access Token

To make authenticated requests on behalf of the user, the authorization_code must be exchanged for an access token. To request an access token, your application should send the this request.

Store both the access_token and the refresh_token. The access token can be used immediately to make authenticated requests but it expires after the expires_in seconds. The refresh token can be used to refresh both tokens.

Note: Be sure to set the Content-Type header field of your request to:

Content-Type: application/x-www-form-urlencoded

A valid request should follow this format (line breaks added for clarity):

GET https://garageio.com/oauth/v2/endpoints/token/?
    client_id=<CLIENT_ID>&
    client_secret=<CLIENT_SECRET>&
    grant_type=authorization_code&
    code=<AUTHORIZATION_CODE>&
    redirect_uri=<ENCODED_REDIRECT_URL>

PreviousStep 2: Handle Authorization ResponseNextStep 4: Call API Endpoints

Last updated 4 years ago