Use the API Reference

Our interactive API reference allows you to try our services. For each resource, the interactive documentation provides you with the following:

• URL
• Description
• Parameter list
• Ability to try each resource with different parameters
• Ability to see the response to a specified request

Interact with the resources and see the responses that you can expect back from the API.  The resources are divided into categories.

To Use the Interactive API Reference:

1. Navigate to the desired product. 
2. Click on the POST /token resource to expand the resource. The /token resource provides an authorization token.

   Note:  You will need an authorization token from the /token resource to try any of the other resources in the MedsAPI. The token endpoint is the same for all products; the product needs to be changed to reflect the endpoints that you want to access.

3. Click the Try it out button within the expanded /token resource.
4. Add the customerID and groupID to the Request body Example Value if you are making a request on behalf of a customer.  This is not required for Dynamic Health Partner endpoints that download offline content.  
5. Replace the {client id} and {client secret} in the Request body Example Value with your clientid and clientsecret. 
6. Replace the product if needed.  The product can be "dynamed", "dynamedex", "health-library", "dynamed-decisions" or "dynamic-health".
7. Add additional body parameters to the Request body if required in your token request.
8. Click the Execute button.  The interface makes a request to the /token endpoint with your desired body parameters.  A successful Response body is displayed.
9. Copy the access_token value from the /token request Response body.
   
10. Scroll to the top of the page of the product you want to use.
11. Click the Authorize button.  
    

    A window will appear.

12. Paste the access_token that you copied in Step 6 into the Value field of the window.
    
13. Click the Authorize button.  Now, you will be able to use the Try it out button on every resource listed without having to gather the token again.
14. Continuing the example using the Dynamic Health Partner endpoints, click your desired resource.  The details for the resource unfold below the resource URL.  A description, successful response format and parameters are listed.
    

15. Click the Try it out button.

16. Enter the parameters that you would like to try in the Description column.  You must enter a parameter for the fields that are marked required.
    

17. Click the Execute button.  The interface makes a request to MedsAPI Dynamic Health EBSCO Partner APIs with your desired parameters.  The Request URL, response code, and response body for your parameters are displayed below the Execute button.