To learn more about the API and practice using the methods, you can either use this guide to make the calls using either a browser or a RESTful addon to a browser.
There are two methods for learning more about the API using your browser.
It is simple to make calls to the API using only your browser's address bar. For the most part, only GET methods will work for this approach.
Go to the API Reference to see which methods exist and which one specifically you would like to test.
Download a JSON formatter so that the output JSON is easily readable.
Google Chrome: Install the JSON Formatter or Pretty JSON addon
Mozilla Firefox: Install the JSONovich addon
Go to your browser's address bar and type in the following url
Followed by the method you would like to see.
An example of how to see the runs the current user has access to using the method GET: users/current/runs, type in the following:
For query parameters, simply add them onto the end of the url you just typed in with a
? after the method call but before typing in the query parameters. Each query parameter is separated by
An example of how to see the runs a current user has access to using the method GET: users/current/runs with query parameters of
limit=10, type in the following:
Install a RESTful addon of your choice:
Google Chrome: Install the Postman RESTful Client, or another RESTful Client of your choice, addon for Google Chrome
Mozilla Firefox: Install the RESTClient, or another RESTful Client of your choice, addon for Mozilla Firefox
Safari: Install the RESTClient, or another RESTful Client of your choice, addon for Safari
Looking at the API Reference, you can now use the methods listed to see the JSON responses from the API, this should give you a better idea of the information that the API gives at each resource level
You will now be able to specify all of the methods through this addon and make GET and POST calls appropriately. The responses are described in detail in the API Reference.