Managing APIs with the Istio Dev Portal happens through the use of two resources: the API Doc and API Product.
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.
Read the full API Doc Spec here
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.
Read the full API Product Spec here