¿Qué es el Centro de API de Azure (versión preliminar)?
El Centro de API permite realizar un seguimiento de todas las API en una ubicación centralizada para la detección, reutilización y gobernanza. Use el centro de API para desarrollar y mantener un inventario estructurado y organizado de las API de su organización -independientemente de su tipo, etapa del ciclo de vida o ubicación de implementación, junto con información relacionada, como detalles de la versión, archivos de definición de API y metadatos comunes.
Con el Centro de API, las partes interesadas de toda la organización, incluidos los administradores de programas de API, los administradores de TI, los desarrolladores de aplicaciones y los desarrolladores de API, pueden detectar, reutilizar y controlar las API.
Importante
- El Centro de API está en versión preliminar. Esta versión preliminar se proporciona sin ningún contrato de nivel de servicio, por lo que es posible que se produzcan cambios importantes mientras siga siendo preliminar. Los cambios en el modelo de datos de la versión preliminar del Centro de API podrían provocar la pérdida de datos. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.
- Durante la versión preliminar, solicite características, notifique errores o proporcione otros comentarios en este repositorio de GitHub.
Nota:
El Centro de API es una solución para que las organizaciones cataloguen y administren el inventario de API. Azure también ofrece el servicio API Management, una solución para administrar, proteger y publicar los backends de API de la organización a través de una puerta de enlace de API. Más información acerca de la diferencia.
Ventajas
Creación y mantenimiento de un inventario organizativo : las organizaciones pueden compilar un inventario completo de las API disponibles en la organización. Fomentar la comunicación y permitir que los administradores de programas de API y los desarrolladores colaboren para aumentar la reutilización de API, la calidad, la seguridad, el cumplimiento y la productividad del desarrollador.
Controlar las API de la organización: con una visibilidad más completa de las API que se generan y usan en una organización, los administradores de programas de API y los administradores de TI pueden controlar este inventario para asegurarse de que cumple los estándares de la organización mediante definir metadatos personalizados y analizar definiciones de API para aplicar la conformidad con las directrices de estilo de API.
Fácil detección de API: las organizaciones quieren promover la reutilización de api para maximizar la productividad de los desarrolladores y asegurarse de que los desarrolladores usan las API adecuadas. El Centro de API ayuda a los administradores de programas y a los desarrolladores a descubrir el inventario de API y filtrar mediante propiedades de metadatos integradas y personalizadas.
Acelerar el consumo de API : Maximice la productividad del desarrollador al consumir las API y asegúrese de que se consumen de forma segura coherente con los estándares de la organización.
Principales capacidades
En versión preliminar, cree y use un centro de API en Azure Portal para lo siguiente:
Administración de inventario de API: registre todas las API de la organización para su inclusión en un inventario centralizado.
Representación real de las API: agregue información real sobre cada API, incluidas versiones y definiciones como las definiciones de OpenAPI. Enumere las implementaciones de API y asócielas a entornos en tiempo de ejecución, por ejemplo, que representan Azure API Management u otras soluciones de API Management.
Gobernanza de API: organice y filtre las API y los recursos relacionados mediante propiedades de metadatos integradas y personalizadas, para ayudar con la gobernanza y la detección de API por parte de los consumidores de API. Configure linting y análisis para aplicar la calidad de la definición de API.
Detección y reutilización de API: permite a los desarrolladores y administradores de programas de API detectar API a través de Azure Portal, un portal del Centro de API y herramientas de desarrollo, incluida una extensión de Visual Studio Code integrada con GitHub Copilot.
Para más información sobre las entidades que puede administrar y las funcionalidades del Centro de API, consulte Conceptos clave.
Regiones disponibles
El Centro de API está disponible actualmente en las siguientes regiones de Azure:
- Este de Australia
- Centro de la India
- Este de EE. UU.
- Sur de Reino Unido
- Oeste de Europa
Centro de API y ecosistema de API
El Centro de API puede servir como rol clave en el ecosistema de API de una organización. Considere la hipotética organización de Contoso, que ha adoptado una estrategia primero de API, haciendo hincapié en la importancia de las API en su desarrollo e integración de software.
Los desarrolladores de API de Contoso, los desarrolladores de aplicaciones, los administradores de programas de API y los administradores de API colaboran a través del Centro de API de Azure para desarrollar y usar el inventario de API de la organización. Consulte el siguiente diagrama y explicación.
El ecosistema de API de Contoso incluye lo siguiente:
Desarrollo de API : Los desarrolladores de Contoso compilan periódicamente las API web de ASP.NET. También crean Azure Functions con desencadenadores HTTP.
Entornos de implementación de API: Contoso implementa una parte de sus API en Azure App Service. Otro subconjunto de sus API se implementa en una aplicación de funciones de Azure.
API Management: Contoso usa Azure API Management para administrar, publicar y proteger sus API. Usan instancias independientes para desarrollo, prueba y producción, cada una con un nombre distinto: APIM-DEV, APIM-TEST y APIM-PROD.
Centro de API : Contoso ha adoptado el Centro de API de Azure como centro centralizado para la detección, gobernanza y consumo de API. El Centro de API sirve como un centro de API estructurado y organizado que proporciona información completa sobre todas las API organizativas, manteniendo información relacionada, incluidas las versiones y las implementaciones asociadas.
Preguntas más frecuentes
P: ¿Cuál es la diferencia entre Azure API Management y Azure API Center?
R: Azure API Management es un servicio de Azure totalmente administrado que ayuda a las organizaciones a exponer de forma segura sus API a clientes externos e internos. Proporciona un conjunto de herramientas y servicios para crear, publicar y administrar API, así como aplicar la seguridad, el escalado y la supervisión del uso de API.
Por otro lado, el Centro de API de Azure ayuda a las organizaciones a crear un catálogo de API que están disponibles en la organización. Azure API Center proporciona información básica sobre las API, como su nombre, descripción y versión, pero se puede agregar información adicional a estas API mediante metadatos personalizados. El Centro de API de Azure ayuda a diferentes partes interesadas, como administradores de API o desarrolladores de API a descubrir y reutilizar las API existentes dentro de la organización.
Aunque ambos servicios proporcionan herramientas para gobernar las API, sirven para diferentes propósitos. Azure API Management es una plataforma para crear, publicar y administrar API, mientras que el Centro de API proporciona una ubicación centralizada para descubrir y reutilizar las API existentes dentro de una organización.
P: ¿Cómo uso el Centro de API con mi solución de API Management?
R: el Centro de API es un servicio independiente de Azure que es complementario a los servicios de Azure API Management y administración de API de otros proveedores. El Centro de API proporciona un inventario unificado de API para todas las API de la organización, incluyendo aquellas API que no se ejecuten en puertas de enlace de API (como las que todavía estén en diseño) y las que se administren con diferentes soluciones de administración de API.
En el caso de las API que se administran mediante una solución de API Management, el Centro de API puede almacenar metadatos como el entorno de ejecución y los detalles de implementación.
P: ¿mis datos se cifran en el Centro de API?
R: sí, todos los datos del Centro de API se cifran en reposo.