Personal/Test OAuth Token Generation

From Active911 Documentation Wiki
Jump to: navigation, search

These directions allow a user to generate a set of tokens for use with the Active911 Developer API

Users can generate Oauth Tokens codes for personal use as long as they have Edit Agency permission for that agency.

This does not require pre-registration of a developer account.

You must use the Active911 OAuth Generation page to generate an access token and a refresh token.

Setup

  1. Go to https://www.active911.com/interface/dev/oauth_gen.php

Generating a refresh token

  1. Select/deselect the scopes you want to apply to the tokens you are generating. This is a space delimited list of one or more of these scopes
  2. Click the "Submit" button. You should be brought to a page which will allow you to select which Agency you want to generate the tokens for.
  3. Select an Agency and click 'Submit'. After selecting an agency, you will be prompted to confirm your authorization.
  4. Click 'Yes'.

After confirming your authorization, you will be brought back to the OAuth page where the Access Token and Refresh token will be shown

Generating an access token from the refresh token

You may generate a new Access Token using your Personal Refresh Token at https://www.active911.com/interface/dev/api_access.php by using a POST request with a "refresh_token" parameter containing your refresh token value.

This will return a JSON object with:

{
 "access_token": "<The access token used to access the api>", 
 "expiration": "<timestamp of when the access token expires>"
}

The Refresh Token is good for 1 year and is used to generate the Access token using the link above.

The Access token is good for 1 day.

Accessing the API

  1. Click "Use this in the api"
  2. The Access token and Refresh token you generated should be autofilled
  3. Start with the url "https://access.active911.com/interface/open_api/api/"
  4. Other API calls can be found here