Athenahealth offers a testing sandbox to interact and develop against their athenaOne and FHIR API server. If you want to try out the Athenahealth Adapter in Iguana X, you’ll first need to login or signup for an Athenahealth developer account and get access credentials:
| Expand |
|---|
| title | Go to https://developer.api.athena.io/ams-portal/ and login or sign up for an Athenhealth developer account |
|---|
|
Go to https://developer.api.athena.io/ams-portal/ and login or sign up with password reset! | Info |
|---|
You computer Public IP needs to be in an Athenahealth supported region (ex. US), otherwise you won’t be able to access Athenahealth Sandbox |
 Image Added |
| Expand |
|---|
| title | Once you're logged in, in the Build Apps tab, click Create a New App |
|---|
|
 Image Added |
| Expand |
|---|
| title | Choose API Access and App Category |
|---|
|
API Access: We use the “My app will use 1+ non-Certified APIs“ option for interacting both AthenaOne and FHIR API AP Category: Select the OAuth method you’ll be using - in our case, we’ll use 2-legged OAuth since Iguana is connecting at a system level
 Image Added
|
| Expand |
|---|
| title | Enter your App details and click Save |
|---|
|
Enter the following required information: Public-facing app name Description App Contact Information Authentication Method For our example, we use “Secret“ but Iguana X is capable of supporting “JWK“ authentication Method
Click on “I Agree“
 Image Added |
| Expand |
|---|
| title | Save App Credentials and Click OK |
|---|
|
Once you submit the details, you’ll receive Your App’s Credentials (Client ID and Secret). Make sure to note these down as you’ll need to load them into the component in Iguana.  Image Added |
| Expand |
|---|
| title | Go to the Scopes page to manage your permissions |
|---|
|
By default, the application will be loaded with the athenaOne scopes, which gives full access to the athenaOne endpoints If you plan to work with FHIR, edit the scopes to include the specific resources you’ll be working with Copy the scope paths as you’ll need to load these into the component in Iguana
 Image Added |
| Expand |
|---|
| title | Check API Rate Limits for daily usage |
|---|
|
Click on “Rate Limits“ tab and observe API Rate Limits. This specifies the number of API calls permitted per second and per day, as well as the number of token requests that can be made per minute. This is especially important to note during development as you can easily make more calls than intended while troubleshooting or writing code.  Image Added |