Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
Publica las API en tu portal a fin de que estén disponibles para su consumo por parte de los desarrolladores de apps, como se describe en las siguientes secciones.
Descripción general de la publicación de API
El proceso de publicación de API en tu portal es un proceso de dos pasos:
- Selecciona el producto de API que deseas publicar en tu portal.
- Genera automáticamente documentación de referencia de la API a partir de una instantánea de tu especificación de OpenAPI para que los desarrolladores de apps puedan obtener información sobre tus API. (Para obtener más información sobre las instantáneas, consulta ¿Qué es una instantánea de una Especificación de OpenAPI?
Cuando publicas una API en tu portal, se realizan las siguientes actualizaciones de forma automática:
Se agrega una página de Referencia de la API a tu portal
En la página Referencia de la API, se muestra la documentación de referencia de la API que generas automáticamente a partir de una instantánea de tu especificación de OpenAPI. Los desarrolladores pueden revisar la documentación de tu API y hacer clic en Probar para realizar una solicitud a la API y ver el resultado.Nota: No puedes editar el contenido de esta página directamente, ya que no aparece en la lista de páginas de tu portal.
Se agregó un vínculo a la página Referencia de la API a la página de las APIs
La página de las APIs (que se incluye con el portal de muestra) proporciona una lista de todas las APIs publicadas en tu portal con vínculos a la documentación de referencia de la API correspondiente para obtener más información.Nota: No puedes editar el contenido de esta página directamente, ya que no aparece en la lista de páginas de tu portal.
¿Qué es una instantánea de una Especificación de OpenAPI?
Cada Especificación de OpenAPI sirve como fuente de información a lo largo del ciclo de vida de una API. Se usa la misma especificación en cada fase del ciclo de vida de la API, desde el desarrollo hasta la publicación y la supervisión. Cuando modificas una especificación, debes conocer el efecto que los cambios tienen en tu API a través de otras fases del ciclo de vida, como se describe en ¿Qué sucede si modificas una especificación?
Cuando publicas tu API, tomas una instantánea de la especificación de OpenAPI para generar documentación de referencia de la API. Esa instantánea representa una versión particular de la especificación en el almacén de especificaciones. Si modificas la especificación de OpenAPI con el editor de especificaciones, puedes tomar otra instantánea de la especificación para reflejar los cambios más recientes en la documentación de referencia de la API.
Agrega compatibilidad con CORS a los proxies de tu API
Antes de publicar tus APIs, deberás agregar compatibilidad con CORS a tus proxies de API para admitir solicitudes de origen cruzado del cliente.
El CORS (uso compartido de recursos multiorigen) es un mecanismo estándar que permite que las llamadas XMLHttpRequest (XHR) de JavaScript que se ejecutan en una página web interactúen con recursos de dominios que no son de origen. CORS es una solución implementada con frecuencia en la política del mismo origen que aplican todos los navegadores. Por ejemplo, si realizas una llamada XHR a la API de Twitter desde la ejecución de un código JavaScript en tu navegador, la llamada fallará. Esto se debe a que el dominio que entrega la página a tu navegador no es el mismo que el dominio que entrega la API de Twitter. El CORS proporciona una solución a este problema, ya que permite que los servidores se “habiliten” si desean proporcionar uso compartido de recursos entre dominios.
Si deseas obtener información para agregar compatibilidad con CORS a los proxies de tu API antes de publicar las APIs, consulta Cómo agregar compatibilidad con CORS a un proxy de API.
Nota: La mayoría de los navegadores modernos aplican CORS. Consulta la lista completa de navegadores compatibles. Para obtener una descripción detallada de CORS, consulta la Recomendación de W3C de uso compartido de recursos entre dominios.
Explora la página de APIs
Para acceder a la página de APIs, haz lo siguiente:
- Selecciona Publicar > Portales y selecciona tu portal.
- Haga clic en APIs en la página principal del portal.
También puede seleccionar APIs en el menú desplegable del portal en la barra de navegación superior.
Se mostrará la lista de APIs.
Como se destaca en la imagen anterior, la página APIs te permite hacer lo siguiente:
- Ver los detalles de las API disponibles en tu portal
- Agregar una API a tu portal
- Tomar una instantánea de la especificación de OpenAPI asociada con un producto de API para actualizar la documentación de referencia de la API
- Publica una API en tu portal o anula su publicación
- Administra el público de una API en el portal
- Edita la especificación asociada (consulta Crea especificaciones mediante el editor de especificaciones).
- Quitar una API de tu portal
- Identifica rápidamente las APIs “huérfanas” cuyo producto de API asociado se quitó de Edge y vuelve a crear el producto de API o borra la API de tu portal
Agrega una API a tu portal
Nota: Puedes agregar un máximo de 100 APIs a tu portal.
Para agregar una API a tu portal, sigue estos pasos:
- Selecciona Publicar > Portales y selecciona tu portal.
- Haga clic en APIs en la página principal del portal.
Como alternativa, puedes seleccionar APIs en el menú desplegable del portal en la barra de navegación superior. - Haz clic en + API.
Aparecerá el diálogo Add API Product to Portal. En la pestaña API Product del diálogo, selecciona el producto de API que desees agregar a tu portal.
Haz clic en Siguiente.
Selecciona el origen que usar para la instantánea.
Si creaste el proxy de API incluido en el producto de API mediante una especificación de OpenAPI, selecciona la especificación de la lista desplegable.
Como alternativa, puedes seleccionar las siguientes opciones:
- Sin especificación y agregar una más adelante después de que se publique la API, como se describe en Cómo tomar una instantánea de la especificación.
- Elige una especificación diferente para seleccionar o subir una especificación nueva.
Selecciona la casilla de verificación Publicada (Published) para publicar la API en tu portal. Anula la selección de Publicada si no estás listo para publicar la API.
Puedes cambiar la configuración más adelante, como se describe en Publicar o anular la publicación de una API en tu portal.En Público, selecciona una de las siguientes opciones para administrar el público de tu API permitiendo el acceso a lo siguiente:
- Usuarios anónimos para que todos los usuarios vean la página.
- Usuarios registrados para que solo los usuarios registrados vean la página.
Puedes cambiar la configuración más adelante, como se describe en Cómo administrar el público para una API en tu portal.
Haz clic en Finish.
Toma una instantánea de la especificación
Después de publicar tu API, puedes tomar una nueva instantánea de la especificación de OpenAPI en cualquier momento para actualizar la documentación de referencia de la API que se publica en tu portal.
Para tomar una instantánea de la especificación de OpenAPI, haz lo siguiente:
- Selecciona Publicar > Portales y selecciona tu portal.
- Haga clic en APIs en la página principal del portal.
Como alternativa, puedes seleccionar APIs en el menú desplegable del portal en la barra de navegación superior. - Coloca el cursor sobre la API de la que deseas tomar una instantánea para mostrar las acciones.
Haz clic en .
Nota: Se mostrará un mensaje si la instantánea está actualizada con la especificación de origen seleccionada.
Selecciona una especificación existente del menú desplegable Snapshot Source o elige Choose a diferente spec para seleccionar o subir una especificación nueva que se use en la generación de documentación para la API. Como alternativa, puedes seleccionar No spec (Sin especificación) para quitar la especificación actual.
Haz clic en Actualizar instantánea (o en Quitar instantánea, si seleccionaste No Spec).
La documentación de referencia de la API se genera a partir de la especificación y se agrega a la página Referencia de la API.
Publica una API en tu portal o anula su publicación
Publica o anula la publicación de una API en tu portal
- Selecciona Publicar > Portales y selecciona tu portal.
- Haga clic en APIs en la página principal del portal.
Como alternativa, puedes seleccionar APIs en el menú desplegable del portal en la barra de navegación superior. - Coloca el cursor sobre la API que desees publicar o anular la publicación.
- Haz clic en .
- Selecciona la casilla de verificación Habilitada para publicar la API en tu portal. Anula la selección de Habilitada para anular la publicación de la API.
- Haz clic en Guardar.
Administra el público de una API en tu portal
Para administrar el público de tu API en el portal, permite el acceso a lo siguiente:
- Todos los usuarios
- Solo los usuarios registrados
Para administrar el público de una API en tu portal, haz lo siguiente:
- Selecciona Publicar > Portales y selecciona tu portal.
- Haga clic en APIs en la página principal del portal.
Como alternativa, puedes seleccionar APIs en el menú desplegable del portal en la barra de navegación superior. - Coloca el cursor sobre la API para la que desees administrar el público para mostrar las acciones.
- Haz clic en .
- En Público, selecciona una de las siguientes opciones:
- Los usuarios anónimos permiten que todos los usuarios vean el producto de API.
- Los usuarios registrados permiten que solo los usuarios registrados vean el producto de API.
- Haz clic en Guardar.
Quita una API de tu portal
Para quitar una API de tu portal, sigue estos pasos:
- Selecciona Publicar > Portales y selecciona tu portal.
- Haga clic en APIs en la página principal del portal.
Como alternativa, puedes seleccionar APIs en el menú desplegable del portal en la barra de navegación superior. - Coloca el cursor sobre la API de la lista para ver el menú de acciones.
- Haz clic en .
Soluciona problemas con tus APIs publicadas
Cuando uses la función Probar, si se muestra el error TypeError: Failed to fetch
, ten en cuenta las siguientes causas y soluciones posibles:
En el caso de los errores de contenido mixto, el error puede deberse a un problema conocido de una IU de Swagger. Una posible solución es asegurarte de especificar HTTPS antes de HTTP en la definición
schemes
en la especificación de OpenAPI. Por ejemplo:schemes: - https - http
En el caso de los errores de restricción de CORS (uso compartido de recursos entre dominios), asegúrate de que CORS sea compatible con los proxies de API. CORS es un mecanismo estándar que habilita las solicitudes de orígenes cruzados del cliente. Consulta Cómo agregar compatibilidad con CORS para un proxy de API. Además, asegúrate de que CORS esté habilitado en tu navegador.