API Products

Managing APIs with the Istio Dev Portal happens through the use of two resources: the API Doc and API Product.

API Docs

API Docs are a Kubernetes Custom Resource which package the API definitions maintained by the maintainers of an API. Each API Doc maps to a single Swagger Specification or set of gRPC descriptors. The APIs endpoints themselves are provided by backend services.

Each API Doc contains the definitions for the individual API operations available to be published as part of an API Product.

API Docs Screenshot

Read the full API Doc Spec here

API Products

API Products are a Kubernetes Custom Resource which bundle the APIs defined in API Docs into a product which can be exposed to ingress traffic as well as published on a Portal UI.

Product owners specify the API Docs and operations they wish to bundle as a single product in their API Products. Each API Product defines Usage Plans specify the tiers of access given to API clients, including how clients are authenticated and rate limited to the APIs they consume.

API Products Screenshot

Read the full API Product Spec here