1. Create an Arity developer account
Contact us to get an account and try out our APIs.
2. Get an API key
Once you have registered for an Arity developer account, sign in and select Dashboard from the top navigation. Click "add new app," fill in app name and select the "Roadside APIs" product, then click "create app."
Your app will be listed on the Dashboard page. Click on the app name to access the Client ID and Client Secret. You will need the Client ID and Client Secret in the next step, so we recommend keeping your Dashboard open in its own tab or copying the values to a text editor.
3. Get an Access Token
Select Get started below "Roadside Service" the left and click on the token API.
Enter the following parameters:
- Content-Type: application/x-www-form-urlencoded
- client_id: Your app's Client ID from the Dashboard
- Authorization: The word Basic, followed by Base64-encoded client_id and client_secret (from Dashboard) inside curly braces
- To generate the Base64-encoded value, go to https://www.base64encode.org/, enter your client_id and client_secret separated by a colon (client_id:client_secret) and click ENCODE.
Alternatively, you can utilize a cURL command as follows:
curl -X POST --header "client_id: YOURCLIENTID" --header "Authorization: Basic {WU9VUkNMSUVOVElEOllPVVJDTElFTlRTRUNSRVQ=}" --header "Content-Type: application/x-www-form-urlencoded" "https://api-sandbox.arity.com/services/roadside/v1/oauth/accesstoken?grant_type=client_credentials"
An Access Token will be generated. Copy the Access Token as you will need it for making other API calls.
4. Try our API
We have a selection of methods for you to try out. Check out the left navigation or the what we do page to see what our API offers.