There are different ways to create and maintain your API documentation in APITree.
You can do everything manually using the APITree UI or programmatically using
the REST API. The REST API can be easily integrated into existing workflows so
that you always have an up-to-date API documentation. In the following we show
you both ways.
Using the APITree UI allows you to ...
- create an API from scratch
- import an existing OpenAPI v2 / v3 file
Login to your APITree account. In the top navigation click on the "
+"
sign and choose eigther
Create new API or
Import
existing API.
If you want to
create a new API from scratch simply give your API a name.
Tip: To directly start with some simple CRUD API endpoints it is recommended
to activate the checkbox Initial CRUD endpoints.
If you want to
import an existing API you just have to choose
the specification file you want to upload and your done.
After the initial creation of the API, the API documentation is displayed. By
clicking on
Expand All the API endpoints / domain models are
shown in detail. The menu entries in the left sidebar refer to the current API.
Under
Settings there is the possibility to switch comments on
and off and to delete the API again. Via
API Editor the API
can be edited in OpenAPI v2 format in JSON or YAML.
There are two different ways to automatically sync your API by using our ...
- GitHub Action
- REST API
Our
GitHub Action can be found on the
GitHub Marketplace. You will find there
information about the usage and how to integrate the action into your workflow.
As an alternative you can directly use our
REST API.
Check our GitHub Action
entrypoint.sh
script to see the needed
curl requests.