Administra tus especificaciones

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X. Información

Apigee Edge te proporciona un lugar para almacenar tus especificaciones de OpenAPI. Administra tus especificaciones de OpenAPI, como se describe en las siguientes secciones.

Para obtener más información sobre las especificaciones de OpenAPI, consulta ¿Qué es una especificación de OpenAPI?

Explorar la lista de especificaciones

Para acceder a la lista de especificaciones, haz lo siguiente:

  1. Accede a apigee.com/edge.
  2. Seleccionar una organización
  3. Selecciona Develop > Specs en el menú de navegación lateral.

Se mostrará la lista actual de especificaciones y carpetas.

Lista de especificaciones

Como se destaca en la imagen anterior, desde la lista de especificaciones puedes hacer lo siguiente:

Crear una nueva especificación de OpenAPI

Para crear una nueva especificación de OpenAPI, sigue estos pasos:

  1. Haz clic en Develop > Specs en la barra de navegación lateral.
  2. Haz clic en + Especificaciones.
  3. Haz clic en Nueva especificación en el menú desplegable. Se abrirá el editor de especificaciones.
  4. Reemplaza la especificación de muestra con tus propios detalles de OpenAPI Specification.
    Consulta Crea especificaciones con el editor de especificaciones.
  5. Haz clic en Guardar para guardar la especificación.
  6. Ingresa un nombre para la especificación cuando se te solicite.
  7. Haz clic en Guardar.

Importa una especificación de OpenAPI

Para importar una especificación de OpenAPI, haz lo siguiente:

  1. Haz clic en Develop > Specs en la barra de navegación lateral.
  2. Haz clic en + Especificaciones.
  3. Haz clic en una de las siguientes opciones del menú desplegable:
    • Importar URL para importar la especificación desde una URL. Especifica el nombre y la URL cuando se te solicite.
    • Import file para buscar la especificación en tu directorio local.
      La especificación se agrega a la lista.
  4. Haz clic en el nombre de la especificación para verla y editarla en el editor de especificaciones.
    Consulta Crea especificaciones con el editor de especificaciones.

Editar una especificación de OpenAPI existente

Para abrir una especificación de OpenAPI existente, sigue estos pasos:

  1. Haz clic en Develop > Specs en la barra de navegación lateral.
  2. Haz clic en la fila asociada con la especificación en la lista de especificaciones.
  3. Edita la especificación en el editor de especificaciones.
    Consulta Crea especificaciones con el editor de especificaciones.

Crea un proxy de API a partir de una especificación de la lista de especificaciones

Con Apigee Edge, puedes crear tus proxies de API a partir de las especificaciones de OpenAPI que diseñas y guardas en el editor de especificaciones. Con solo unos pocos clics, tendrás un proxy de API en Apigee Edge con las rutas de acceso, los parámetros, los flujos condicionales y los extremos de destino generados automáticamente. Luego puedes agregar características como la seguridad de OAuth, el límite de frecuencia y el almacenamiento en caché.

Después de crear un proxy de API a partir de una especificación de OpenAPI, si se modifica la especificación, deberás modificar manualmente el proxy de API para reflejar los cambios implementados. Consulta ¿Qué sucede si modifico una especificación?

Para crear un proxy de API a partir de una especificación de OpenAPI en la lista de especificaciones, haz lo siguiente:

  1. Selecciona Develop > Specs en el menú de navegación lateral.
  2. Navega a la carpeta que contiene la especificación de OpenAPI, si es necesario.
  3. Posiciona el cursor en la especificación de OpenAPI para la que deseas crear un proxy de API a fin de mostrar el menú de acciones.
  4. Haz clic en generar proxy. Se abrirá el asistente de creación de proxy y la página de detalles del proxy se prepropagará con valores de la especificación de OpenAPI, como se muestra en la siguiente figura.
    asistente de compilación de proxy
  5. Presiona Siguiente.
  6. Recorre las páginas restantes del asistente de creación de proxy, como se describe en Crea un proxy de API a partir de una especificación de OpenAPI. (Comienza desde el paso 8).

Cambia el nombre de una especificación

Para cambiar el nombre de una especificación, sigue estos pasos:

  1. Selecciona Develop > Specs en el menú de navegación lateral.
  2. Navega hasta la carpeta que contiene la especificación, si es necesario.
  3. Coloca el cursor sobre la especificación a la que deseas cambiarle el nombre para mostrar el menú de acciones.
  4. Haz clic en Cambiar el nombre de la especificación.
  5. Edita el nombre de la especificación.
  6. Haz clic en Cambiar nombre para guardar las modificaciones o en Cancelar para cancelarla.

Mueve una especificación a una carpeta

Puedes organizar tus especificaciones en carpetas para facilitar la administración y la seguridad. Para mover una especificación a una carpeta, consulta Organiza especificaciones mediante carpetas.

Borrar una especificación

Puedes borrar una especificación del almacén de archivos cuando ya no sea necesaria o no sea válida.

Para borrar una especificación, haz lo siguiente:

  1. Selecciona Develop > Specs en el menú de navegación lateral.
  2. Coloca el cursor sobre la especificación que deseas borrar para mostrar el menú de acciones.
  3. Haz clic en Ícono Borrar.
  4. Haz clic en Borrar para confirmar la operación de eliminación en el mensaje.
  5. Borra los artefactos relacionados que ya no sean necesarios.