3.0.11OAS 3.0

N/A (this description is removed during bundling)

API Base URL
Security
portalAccessToken (apiKey)

The Developer portal cookie is meant to be used by the Developer API to authenticate with.

Additional Information
Contact Kong

APIs

Endpoints for viewing APIs published to the portal.

Get API

Gets the details for an existing published API.

get
/api/v3/apis/{apiIdOrSlug}

Path Parameters

apiIdOrSlugOne Of
required

The API identifier, either ApiId or Api Slug

ApiIdstring(uuid)read-only

The API identifier.

Example:9f5061ce-78f6-4452-9108-ad7c02821fd5

Response

application/json

Response for a single api’s details.

Api

* Additional properties are NOT allowed.
idstring(uuid)requiredread-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

namestringrequired

Name of API.

Example:Billing

versionstring | nullrequired

Version of API.

Example:v1

descriptionstring | nullrequired

Example:V1 API for billing functions

visibilitystringrequired

Visibility of the API listing.
Public APIs are visible to anyone and do not require authentication to view and retrieve information about them.
Private APIs are only visible to authenticated developers who have been granted access.

Allowed values:publicprivate

slugstringrequired

The API slug is used in generated URLs to provide human readable paths.

Defaults to slugify(name + version)

Match pattern:^[\w-]+$

Example:my-api-v1

auth_strategiesOne Of
array[object]

Configurations for how the API is able to be registered for by applications.

AuthStrategyKeyAuthobject

KeyAuth Auth strategy that the application uses.

* Additional properties are NOT allowed.
Show Child Parameters
specificationsarray[object]requiredDEPRECATED

Returns a list of specifications for an API.
Note: This Beta property is deprecated and will be removed in a GA release.

Show Child Parameters
current_version_summaryobject | null

Summary of the current version (version string of api.version matches version)

* Additional properties are NOT allowed.
Show Child Parameters
attributesobjectrequired

A set of attributes that describe the API

Example:{"availability":["general"],"domain":["financial","billing"]}

imagesobject | nullread-only

Example:{"icon":{"uri":"/apis/ebbac5b0-ac89-45c3-9d2e-c4542c657e79/images/icon/raw"}}

* Additional properties are NOT allowed.
Show Child Parameters
application/json