Puertas de enlace API de Jitterbit

Descripción general

Cuando se llama a un API Manager API, la conectividad a la API se habilita a través de una puerta de enlace API. Las puertas de enlace API manejan las tareas de seguridad involucradas en la aceptación y procesamiento de llamadas realizadas a un API Manager API.

Hay dos tipos de puertas de enlace API:

Puertas de enlace API en la nube: Estas puertas de enlace son alojadas y gestionadas por Jitterbit.
Puertas de enlace API privadas: Estas puertas de enlace son instaladas, alojadas y gestionadas por usted. Proporcionan control total sobre la autorización, el enrutamiento, las tarifas y el almacenamiento y procesamiento de cargas útiles de sus APIs.

Cronograma de lanzamientos y notas de lanzamiento

El cronograma de lanzamientos para la puerta de enlace API varía según el tipo de puerta de enlace:

La puerta de enlace API en la nube se actualiza automáticamente siguiendo el cronograma de lanzamientos de Harmony.
Un instalador actualizado de la puerta de enlace API privada está disponible en la página de Descargas al concluir el lanzamiento de Harmony y la actualización del Grupo de Agentes en la Nube de Sandbox.
La imagen Docker de la puerta de enlace API privada está disponible en Docker Hub al concluir el lanzamiento del Grupo de Agentes en la Nube de Producción de la región de América del Norte (NA).

En las notas de lanzamiento de Harmony, cada tipo de puerta de enlace API se incluye como un elemento separado en la tabla de fechas de lanzamiento en la parte superior de cada página de notas de lanzamiento. Las notas de lanzamiento individuales se enumeran bajo el encabezado Puerta de enlace API, con cualquier aplicabilidad relevante a ciertos tipos de puertas de enlace incluida dentro de las notas de lanzamiento.

Límites de solicitudes y manejo de errores

Las puertas de enlace API implementan límites de solicitudes y devuelven estos códigos de error HTTP para los siguientes errores. Pueden aplicarse límites adicionales a nivel de plataforma dependiendo del tipo de puerta de enlace.

Código de error HTTP	Descripción
`403 (Prohibido)`	La puerta de enlace de la API rechazó la solicitud debido a permisos insuficientes o fallo de autenticación. Esto ocurre cuando la solicitud carece de credenciales válidas, utiliza una clave de API caducada o inválida, viola restricciones de dirección IP, o intenta acceder a una API sin la autorización adecuada a través del perfil de seguridad asignado.
`404 (No encontrado)`	No se pudo encontrar el punto final de la API solicitado. Esto ocurre típicamente cuando la URL del servicio es incorrecta, la API ha sido despublicada o eliminada, el prefijo de la URL del entorno es inválido, o hay una discrepancia en la versión de la API o la raíz del servicio especificada en la URL de la solicitud.
`414 (URI demasiado grande)`	La URL del servicio de API excede el límite de 8,000 caracteres.
`429 (Demasiadas solicitudes)`	La solicitud es rechazada debido a limitación de tasa. Esto ocurre cuando la solicitud excede el límite de hits de API por minuto permitido para la organización, viola los límites de tasa a nivel de entorno, excede los límites de tasa del perfil de seguridad, o cuando la organización ha consumido su límite mensual de hits de API.

Además de los límites mencionados, el gateway de API en la nube gestionado por Jitterbit impone un límite a nivel de plataforma de 200 solicitudes de API por minuto por organización. Las solicitudes que superen este umbral pueden ser limitadas por la plataforma. Este límite se aplica de manera colectiva a todos los tipos de API, incluidas las API personalizadas, las API proxy y las solicitudes OData. Este límite no se aplica a los gateways de API privados, donde el rendimiento se determina por la capacidad del servidor anfitrión.