Página de APIs en Jitterbit API Manager

Introducción

La página APIs es la página de aterrizaje de API Manager y brinda a los administradores de la organización Harmony la capacidad de administrar APIs personalizadas, Servicios OData y APIs de proxy creado a través de API Manager.

Miembros de un rol al que se le ha otorgado acceso de lectura al ambiente también pueden acceder a la página APIs para ver las APIs de ese ambiente. Los miembros de un rol con acceso de escritura al ambiente tienen acceso de escritura en ese ambiente.

Para acceder a la página APIs, inicie sesión en el portal Harmony, luego use el menú del portal Harmony en la parte superior izquierda para ir a API Manager > APIs:

Asegúrese de acceder a la organización deseada, que puede cambiarse en la barra de navegación superior (consulte Cambiar la organización seleccionada en Portal de Harmony)

Encabezado de la página de APIs

El encabezado en la parte superior de la página APIs incluye estos controles:

• URL base: La URL de API base de la organización Harmony.

URLs de API personalizada utilizadas: El número de URLs de API personalizadas utilizadas actualmente, del total permitido por la suscripción de la organización. Las URLs de API API actualmente son las utilizadas por las APIs personalizadas y de OData publicadas, y sus clones publicados. Las APIs en borrador no se consideran URLs de API en uso.

URLs de proxy de API utilizadas: El número de URLs de API de proxy utilizadas actualmente, del total de URLs de API de proxy permitidas por la suscripción de la organización. Las URLs de API de proxy utilizadas actualmente son las utilizadas por las APIs de proxy publicadas y sus clones publicados. Los borradores de APIs no se consideran URLs de API en uso.

• Filtro: Abre un panel con controles para filtrar la tabla por Tipo de API, Estado de API, Grupo de API, Ambiente, Perfil de seguridad y fechas de Última edición y Última publicación:

  

  Los filtros se aplican inmediatamente. Utilice los botones Borrar o Borrar todo para restablecer los filtros. Botón Cerrar para cerrar el panel.

• Buscar: Introduzca cualquier parte del nombre de la API, la versión, el ambiente, el tipo, la descripción, el estado o la fecha u hora de su última publicación o edición en el cuadro de búsqueda para filtrar la lista de APIs (solo caracteres alfanuméricos). La búsqueda no distingue entre mayúsculas y minúsculas.

• Ver: Haga clic en el vista de ficha o vista de lista para alternar el formato de visualización de las APIs en esta página. La vista de mosaico es la vista predeterminada inicial. La próxima vez que cargue la página APIs, se preseleccionará la última vista seleccionada.

• Importar API: Abre la pantalla de importación de API, donde puedes importar APIs en formato APK (consulta Exportar e importar APIs)

• Exportar API: Abre la pantalla de exportación de API, donde puedes exportar las APIs seleccionadas en formato APK (consulta Exportar e importar APIs).

• Nuevo: Utilice el menú para seleccionar el tipo de API a crear, ya sea API personalizada o proxy de API:

  • API personalizada: (Disponible solo si hay una URL de API personalizada disponible). Abre la pantalla de configuración de API para crear una nueva personalizada o OData API.

  • proxy de API:(Disponible solo si hay una URL de API de proxy disponible). Abre la pantalla de configuración de API de proxy para crear un nuevo proxy API.

Vista de mosaico

Para acceder a la vista de ficha, seleccione el Icono de vista de mosaico.

La vista de mosaico muestra las APIs como mosaicos. Cada ficha tiene una parte frontal y una posterior que se pueden girar para revelar información y acciones adicionales de la API. La parte frontal se muestra por defecto. La parte posterior se muestra al pasar el cursor sobre el ficha.

• Frente: El frente del ficha muestra el nombre de la API, la versión, el ambiente, el tipo de API (Personalizada, OData o Proxy), el estado de la API (Publicada, Publicada con borrador o Borrador) y la última fecha de edición o publicación (en MM/DD/YY Formato) en la hora local del navegador. El color del icono a la izquierda del estado de la API indica la categoría del estado de la API:

  Icono	Color	Categoría
  	Verde	La API está publicada.
  	Amarillo	La API se publica con un borrador.
  	Abierto Verde	La API es un borrador.

• Reverso: El reverso del ficha (visible al pasar el cursor sobre ficha) muestra el nombre de la API, el ambiente, la descripción de la API y el nombre del usuario que la editó por última vez. Además, están disponibles las siguientes acciones:

  • Ver/Editar: Abre la pantalla de configuración de API (vea Configuración de API personalizada, Configuración del servicio OData, o Configuración de proxy de API).

  • Acciones: Haz clic en el Icono del menú de acciones para abrir un menú con estas acciones:

    Elemento del API	Descripción
    	Registros de API abre los Registros de API página, que muestra registros de procesamiento y depurar (si el registro de depurar está habilitado) para todas las APIs.
    	Analytics abre Analytics página, que muestra métricas de consumo y rendimiento para todas las APIs.
    	Clonar abre la pantalla de configuración de API (vea Configuración de API personalizada, Configuración del servicio OData, o Configuración de proxy de API), precargado con los detalles de configuración de la API clonada y valores predeterminados actualizados para estos campos: Nombre de la API: El nombre de la API se antepone con Copia de. Raíz del servicio: La raíz del servicio se antepone con Copia de. ** Versión:** La versión se antepone con -2. Este número no aumenta con clones adicionales.
    	Exportar inicia una descarga de la API a un archivo llamado apis-export.apk Este archivo se puede importar luego a un ambiente u organización diferente (consulte Exportación e importación de APIs).
    	Eliminar elimina permanentemente la API. Al hacer clic en Eliminar, se muestra un cuadro de diálogo para confirmar que desea eliminar la API permanentemente. Precaución Documentación de OpenAPI mostrada en el Portal la página no se actualiza automáticamente al eliminar una API. Para actualizar la documentación de OpenAPI, hágalo a través del Administrador del Portal página.

  • Copiar URL: Copia la URL de la API a su portapapeles.

Vista de lista

Para acceder a la vista de lista, seleccione el icono Icono de vista de lista.

La vista de lista muestra las APIs en una tabla, con cada columna descrita a continuación. Al hacer clic en una fila de API, se abre el panel de detalles de la API .#api-details-drawer) (descrito a continuación).

Las columnas disponibles son los siguientes:

• Nombre de la API: El nombre de la API.

• Versión La versión de la API, tal como se ingresó durante la configuración de la API.

• Tipo: El tipo de API, uno de los siguientes:** API personalizada, **Servicio OData o proxy de API.

• Ambiente: El ambiente donde se almacena la API.

• Estado: El estado de la API, uno de Publicado, Publicado con borrador, o Borrador.

• Última edición: La última fecha guardada (en MM/DD/YYYY formato), hora (en HH:MM:SS formato) y el período de tiempo (AM o PM) en la hora local del navegador.

• Raíz del servicio: El nombre público de la API, tal como se ingresó durante la configuración de la API.

• Grupo: El nombre de cualquier grupo de API a la que pertenece la API.

• Editado por: El nombre del usuario que guardó la API por última vez.

• Última publicación: La fecha de publicación (en MM/DD/YYYY formato), hora (en HH:MM:SS formato) y el período de tiempo (AM o PM) en la hora local del navegador.

• Publicado por: El nombre del usuario que publicó la API por última vez.

• Puerta de enlace: La puerta de enlace API utilizado por la API.

• Servicios: La cantidad de servicios configurados para la API.

• Acciones: Pase el cursor sobre la fila API para revelar acciones adicionales:

  • Detalles: Abre el cajón de detalles de la API (descrito en la siguiente sección).

  • Copiar URL base de la API: Haga clic para copiar la URL base de la API a su portapapeles.

  • Exportar: Abre el selector de carpetas de su equipo local. Seleccione una carpeta para guardar la exportación de la API. Para más información, consulte Exportar e importar APIs.

  • Editar: Abre la página Resumen y confirmación de la API, donde puedes editar la configuración de la API.

  • Más acciones: Abre un menú con estas acciones:

    Elemento del API	Descripción
    Clonar	Abre la pantalla de configuración de API (vea Configuración de API personalizada, Configuración del servicio OData, o Configuración de proxy de API), precargado con los detalles de configuración de la API clonada y valores predeterminados actualizados para estos campos: Nombre de la API: El nombre de la API se antepone con Copia de. Raíz del servicio: La raíz del servicio se antepone con Copia de. ** Versión:** La versión se antepone con -2. Este número no aumenta con clones adicionales.
    Eliminar	Elimina la API permanentemente. Al hacer clic en Eliminar, se muestra un cuadro de diálogo para confirmar que desea eliminar la API permanentemente. Precaución Documentación de OpenAPI mostrada en el [Portal](/es/api-manager/api-manager-user-interface/portal`La página no se actualiza automáticamente al eliminar una API. Para actualizar la documentación de OpenAPI, hágalo a través del Administrador del Portal página.
    Ver en el portal	(Habilitado solo para APIs personalizadas o proxy con estado Publicado o Publicado con borrador). Abre el Portal página para la API.
    Ver registros	Abre los Registros de API página, que muestra registros de procesamiento y depurar (si el registro de depurar está habilitado) para todas las APIs.
    Análisis	Abre Análisis página, que muestra métricas de consumo y rendimiento para todas las APIs.

Cajón de detalles de la API

Para ver los detalles de una API, seleccione una API en la tabla mientras está en vista de lista. Se abre un cajón en la parte inferior de la ventana con cinco pestañas: Perfil, Ajustes, Servicios, Perfiles de seguridad, Roles de usuario (para APIs personalizadas y servicios OData) y Encabezados de solicitud (para APIs de proxy).

El encabezado del cajón muestra estos detalles y controles:

• Nombre y versión de la API: Muestra el nombre de la API y su versión (si corresponde).
• Anterior / Siguiente: Navega por la lista de APIs de la organización.
• Expandir: Expande el cajón a pantalla completa. Una vez expandido, haga clic en el Minimizar el icono para volver a la vista anterior.
• Cerrar: Cierra el cajón.

Pestaña de perfil

La pestaña Perfil muestra información general sobre la API:

• Tipo de API: El tipo de API, uno de los siguientes:** API personalizada, **Servicio OData o proxy de API.

• URL base de la API: La URL base de la API.

• Descripción: (visible solo para APIs personalizadas y servicios OData). La descripción de la API, tal como se ingresó durante la configuración de la API.

• URL de API existente: (visible solo para APIs de proxy). La URL de la API a proxy.

Pestaña de configuración

La pestaña Configuración proporciona una descripción general de las configuraciones de la API (especificadas durante la configuración de la API):

Nota

Para editar cualquiera de estas configuraciones, debe hacer clic en Editar en la columna Acción de la API en la tabla.

• Tiempo de espera: El número de segundos antes de que la API expire. El valor predeterminado es 30 segundos. El máximo es 180 segundos.

  Nota

  Esta configuración es independiente de la configuración del tiempo de espera de la operación en Integration Studio o Design Studio. Las configuraciones de tiempo de espera de operación no se utilizan a menos que un agente privado se utiliza y el EnableAPITimeout configuración en el archivo de configuración del agente privado está habilitado.

• Solo SSL: Cuando está habilitado (predeterminado), los datos se cifran a través de SSL y se aplica HTTPS para todas las solicitudes y respuestas de API (recomendado).

  Al deshabilitarse, los datos transmitidos a través de las solicitudes y respuestas de la API no se cifran y pueden ser interceptados y vistos por otros. Esto podría exponer información confidencial.

• CORS: Cuando está habilitado, el Intercambio de recursos entre orígenes (CORS) se utiliza el mecanismo (no se recomienda).

  Advertencia

  CORS provoca operaciones que utilizan el OPTIONS Método para ejecutar sin autenticación.

• Habilitar registro detallado: Cuando está habilitado, el registro detallado de las APIs incluye datos de solicitud y respuesta en cada registro de API para supervisar los datos entrantes y salientes y facilitar la depuración. Esta opción está deshabilitada de forma predeterminada, ya que puede generar archivos de registro de gran tamaño.

• Habilitar modo de depuración hasta: Muestra la fecha y la hora en que se deshabilitará el modo de depurar.

Pestaña de servicios

La pestaña Servicios tiene una tabla con una descripción general de los servicios de API:

La tabla se puede ordenar por Nombre del servicio, Método, Ruta, Proyecto, Operación a activar o Tipo de respuesta haciendo clic en la fila del encabezado correspondiente.

• Nombre del servicio: El nombre del servicio API.

• Método: El método de solicitud para el servicio API, uno de GET, POST, PUT, DELETE, ALL o (si el Método está configurado como CUSTOM) el nombre del método personalizado.

• Ruta: La ruta para la solicitud.

• Proyecto: (visible solo para APIs personalizadas y servicios OData). El nombre del proyecto de Integration Studio.

• Operación a activar: (visible solo para APIs personalizadas y servicios OData). El nombre de la operación que se llama.

• Tipo de respuesta: (visible solo para APIs personalizadas y servicios OData). El tipo de respuesta, uno de los siguientes: Objetivo final, Variable del sistema o Sin respuesta.

• Acciones: Pase el cursor sobre la fila de servicio para revelar acciones adicionales:

  • Copiar URL del servicio API: Copia la URL del servicio API al portapapeles.

  • Ir al servicio API: Abre la página Resumen y confirmación de la API, donde puede editar la configuración de la API.

Pestaña de perfiles de seguridad

La pestaña Perfiles de seguridad proporciona una lista de todos los perfiles de seguridad se utiliza para restringir el acceso para el consumo de la API:

La tabla se puede ordenar por Nombre de perfil, Tipo o Nombre de usuario haciendo clic en la fila de encabezado correspondiente.

• Nombre del perfil: El nombre del perfil de seguridad.

• Tipo: El tipo de autenticación, uno de los siguientes: Anónimo, Clave API, Básico o OAuth 2.0.

• Nombre de usuario: Muestra el nombre de usuario para cualquier perfil de seguridad que utilice autenticación básica. De lo contrario, se muestra el tipo de autenticación.

• Acciones: Pase el cursor sobre la fila del perfil de seguridad para revelar una acción adicional:

  • Ir al perfil de seguridad: Abre la pantalla de configuración para el perfil de seguridad.

Pestaña de roles de usuario

La pestaña Roles de usuario proporciona una lista de los roles de la organización cuyos miembros tienen acceso a la API:

Nota

Esta pestaña solo es visible para APIs personalizadas y servicios OData.

La tabla se puede ordenar por Rol de usuario haciendo clic en la fila de encabezado correspondiente.

• Rol de usuario: El nombre del rol de usuario de Harmony.

• Acciones: Pase el cursor sobre la fila del rol del usuario para revelar una acción adicional:

  • Ir al rol de usuario: Abre la Administración de usuarios de la Consola de administración página.

Pestaña de encabezados de solicitud

La pestaña Encabezados de solicitud proporciona una lista de los encabezados de solicitud de la API de proxy:

Nota

Esta pestaña solo es visible para las APIs de proxy.

La tabla se puede ordenar por Clave o Valor haciendo clic en la fila de encabezado correspondiente.

• Clave: La clave del encabezado de la solicitud.

• Valor: El valor del encabezado de la solicitud.

• Anular entrada: Cuando está habilitado, el encabezado de solicitud anula otros encabezados de solicitud que usan la misma Clave.

  Nota

  Para editar esta configuración, haga clic en Editar en la columna Acción de la API en la tabla.

Configuración de la página de vista de lista

Puede ordenar la tabla, reorganizar sus columnas o actualizar su contenido:

• Ordenar: Para ordenar la tabla en orden ascendente, haga clic en el encabezado de cualquier columna. Vuelva a hacer clic para invertir el orden.

• Columnas: Para cambiar la disposición y la visibilidad de las columnas, haga clic en Filtrar columnas. Se abre el panel Columnas:

  

  El cajón tiene los siguientes controles:

  • Buscar: Introduzca cualquier parte del nombre de la columna en el cuadro de búsqueda para filtrar la lista de columnas (solo caracteres alfanuméricos). La búsqueda no distingue entre mayúsculas y minúsculas.

  • Mostrar todo: Mostrar todas las columnas.

  • Mover: Arrastre y suelte para cambiar la posición de la columna con respecto a las demás.

  • Ocultar: La columna está visible. Haz clic para ocultarla.

  • Mostrar: La columna está oculta. Haz clic para mostrarla.

  • Guardar: Guarda las columnas.

  • Cancelar: Cierra el panel de columnas sin guardar los cambios.