View source for Personal/Test OAuth Token Generation

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 [[Understanding permissions|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==
#Go to https://console.active911.com/interface/dev/oauth_gen.php

==Generating a refresh token==

#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 [[OAuth Scopes|these scopes]]
#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.
#Select an Agency and click 'Submit'.  After selecting an agency, you will be prompted to confirm your authorization.  
#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://console.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==
#Click "Use this in the api"
#The Access token and Refresh token you generated should be autofilled
#Start with the url "https://access.active911.com/interface/open_api/api/"
#Other API calls can be found [[Accessing the API|here]]