Kong Konnect offers a suite of official APIs, as documented here: https://docs.konghq.com/konnect/api/.
More official "v2" APIs are in-flight, including Runtime Group Configuration APIs (aka Gateway "Admin API") as well as APIs for Service Hub, Analytics, and Developer Portal.
However, to help customers who must build automation against the existing "v1" APIs, these scripts can be used to build automation for managing Service Package markdown documentation & Service Version Open API Specs.
You will need a Personal Access Token, as well as the Service Package ID (e.g. https://cloud.konghq.com/us/servicehub/5bdf66c1-02a9-4ef5-b32f-7791c0f59be0/overview
--> 5bdf66c1-02a9-4ef5-b32f-7791c0f59be0
) and
Service Version ID (e.g. https://cloud.konghq.com/us/servicehub/5bdf66c1-02a9-4ef5-b32f-7791c0f59be0/versions/9fbeed10-6cf5-42b7-ad1f-6bbeed93d46b
--> 9fbeed10-6cf5-42b7-ad1f-6bbeed93d46b
).
IMPORTANT NOTE: These APIs are not official and will be deprecated & removed once we ship v2 Service Hub APIs
Gets the list of all the Service Packages you have access to
Gets the list of all the service versions associated with a particular Service Package
If exist, remove the documentation associated with a particular Service Package and then uploads the markdown document, "Petstore.md" to the defined Service Package
If exist, remove the OpenAPI specification associated with a particular service version and then uploads the OpenAPI Spec, "Petstore_oas2.yaml" to the defined Service Version
Deletes the Documentation associated with a particular Service Package
Deletes the OpenAPI Specification associated with a particular Service Version
Gets the documentation currently associated with a particular Service Package
Gets the API spec currently associated with a particular Service Version
Download the markdown document, to the defined Service Package
Update the markdown document using service.name to get needed ID Be care to get correct version id.
Update the openAPI specification file using service.name to get needed ID Be care to get correct version id.
Publish service id to Dev Portal using service.name
Unpublish service id to Dev Portal using service.name
Configure the Service Version status (Published or Unpublished) in the developer portal