Ziti controlller REST API
The API version and Swagger definition for a particular controller may be fetched and there are relatively good documents available as well, also served directly from the controller. There are two main endpoints
Client API
The client api services are used by endpoints to interact with the Ziti Network. These services are necessary to authenticate, enroll, return services and fetch other information related to the endpoint's participating in the network.
Download the Client API Spec
The client api spec can be downloaded from your controller at the following url (replace "${CONTROLLER_URL}" accordingly) https://${CONTROLLER_URL}/edge/client/v1/docs.
Management API
The management api is used to configure, manage, and maintain the Ziti Network.
Download the Management API Spec
The client api spec can be downloaded from your controller at the following url (replace "${CONTROLLER_URL}" accordingly) https://${CONTROLLER_URL}/edge/management/v1/docs.
Example
Find the controller version
Here's one of many examples you'll find linked in the docs
GET /
{
"data": {
"apiVersions": {
"edge": {
"v1": {
"path": "/edge/v1"
}
}
},
"buildDate": "2021-04-23 18:09:47",
"revision": "fe826ed2ec0c",
"runtimeVersion": "go1.16.3",
"version": "v0.19.12"
},
"meta": {}
}