Accela provides a test API token utility and sandbox environment for learning and testing purposes.
Accela API resources that access Civic user data (such as address, parcel, owner, contact, professional, inspection, payment, record, workflow, and report information) require an API access token for authentication. For testing purposes, you can generate test API access tokens for your Accela API calls.
Note: Not all of the Construct API resources require access tokens. The API resource's authentication type determines whether or not it requires an access token. The API Reference index shows each resource's authentication type. If an API resource's authentication type requires an access token, the HTTP request calling that API resource must specify the access token value in the Authorization request header.
The Developer Portal provides a utility that generates test API access tokens:
https://developer.accela.com/TestToken/Index
1. Go to https://developer.accela.com/TestToken/Index. If you are not logged in the Accela Developer Portal, you will be prompted to login.
2. Complete the required fields:
Client (My App) |
Select the app from the list of your registered apps. |
Agency Name |
Enter islandton. The test server environment uses Islandton as a test agency. |
Scope |
Enter either the scope name(s) or scope group(s) of the Accela API you want to test. The value you enter binds the API token to the API methods associated with the specified scope(s). If you need more than one scope, separate each scope name or group with a space. To get the appropriate scope name or group, refer to the API Resource Information in the Construct API Reference. In the example illustrated above, get_contacts is the scope for Get All Contacts, Get All Contacts for Record, Create Record Contacts, and Update Record methods, enter “get_contacts records” as illustrated in the example above. get_contacts is the scope name for Get All Contacts, and records is the scope group representing the record-related API methods in this example. |
3. Click Submit.
You will be prompted to sign in your app.
4. Enter the test login information:
User Name |
developer |
Password |
accela |
<Environment> |
TEST |
5. Click Allow to give your app permission to perform API requests on your behalf (developer user, in this case).
The generated test API token will be displayed. You can copy the Token string to your test tool or code.
