Descripción general de los recursos de API

Esta página se aplica a Apigee y Apigee Hybrid.

Cuando registras una API con el concentrador de APIs, creas y almacenas una entidad que representa a la API. Esta entidad se denomina recurso de API. Los recursos de API almacenados en el concentrador de APIs se pueden buscar y proporcionan información operativa y descriptiva detallada sobre la API.

Un recurso de API es una entidad compleja que puede tener una o más versiones asociadas. Puedes pensar en una versión como el estado de una API en un momento determinado. Cada versión puede tener su propio conjunto de entidades, como operaciones analizadas a partir de una especificación de API, implementaciones y especificaciones de API, como se muestra en la Figura 1.

Relaciones de entidades de la API.

Figura 1. Una API puede tener varias versiones.

Ya sea cuando registras una API o después, puedes agregar y editar atributos de recursos de API para crear una descripción detallada de la API, incluida la versión, el propietario, la información de la empresa, los usuarios de destino y mucho más. ConsultA Administra atributos.

El concentrador de APIs admite atributos definidos por el sistema y por el usuario. Estos son algunos ejemplos de atributos definidos por el sistema:

  • Estilo de API: Un atributo con valores predeterminados de REST, gRPC, SOAP y API asíncrona.
  • Usuarios de destino: Los usuarios previstos (consumidores) de una API
  • Equipo: Los equipos de producción o de producción responsables de una API
  • Unidad de negocios: La unidad de negocios responsable de una API
  • Nivel de madurez: una indicación de la etapa del ciclo de vida de la API

Por último, un recurso de API puede tener atributos definidos por el usuario, que defines en Configuración según las necesidades de tu organización o equipo.