Swagger is a simple yet powerful representation of your REST API. With the largest ecosystem of API tooling on the planet, thousands of developers are supporting Swagger in almost every modern programming language and deployment environment. With a Swagger-enabled API, you get interactive documentation, client SDK generation and discoverability.
We have included Swagger representation and documentation for the REST API. It can be accessed through the API Settings page under Administration » Integration » API (REST).
Once loaded, you will be presented with all the classes and methods, so that you can test by invoking them through the Swagger interface. In this example, we can see Project and all the methods to perform 'GET', 'POST' and 'DELETE' calls.
If you click on the 'GET' method for '/project/active', you will be able to choose the Response Content Type and choose the ModelProperties you want to return from the object. In this specific method, there are no required parameters, but other methods may require various parameters such as:
- JSON Object
In the Parameters section, you can set the Parameter, Value, Description, Parameter Type and the Data Type expected for the method.