Saltar al contenido

Puertas de enlace de API de Jitterbit

Descripción general

Cuando se llama a una API de API Manager, la conectividad a la API se habilita a través de una puerta de enlace de API. Las puertas de enlace de API se encargan de las tareas de seguridad implicadas en aceptar y procesar llamadas realizadas a una API de API Manager.

Existen dos tipos de puerta de enlace de API:

Calendario de lanzamiento y notas de la versión

El calendario de lanzamiento de la puerta de enlace de API varía según el tipo de puerta de enlace:

  • La puerta de enlace de API en la nube se actualiza automáticamente siguiendo el calendario de lanzamiento de Harmony.

  • Un instalador de puerta de enlace de API privada actualizado está disponible en la página Descargas al finalizar el lanzamiento de Harmony y la actualización del grupo de agentes en la nube de Sandbox.

  • La imagen de Docker de la puerta de enlace de API privada está disponible en Docker Hub al finalizar 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 la versión de Harmony, cada tipo de puerta de enlace de API se incluye como un elemento de línea separado en la tabla de fechas de lanzamiento en la parte superior de cada página de notas de la versión. Las notas de la versión individuales se enumeran bajo el encabezado Puerta de enlace de API, con cualquier aplicabilidad relevante a ciertos tipos de puerta de enlace incluida dentro de las notas de la versión.

Límites de solicitud y manejo de errores

Las puertas de enlace de API implementan límites de solicitud y devuelven estos códigos de error HTTP para los siguientes errores. Pueden aplicarse límites adicionales a nivel de plataforma según el tipo de puerta de enlace.

Código de error HTTP
 Descripción
403 (Prohibido) La puerta de enlace de 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 expirada 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 de conexión de API solicitado. Esto generalmente ocurre cuando la URL del servicio es incorrecta, la API ha sido despublicada o eliminada, el prefijo de 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 se rechaza debido a limitación de velocidad. Esto ocurre cuando la solicitud excede la asignación de visitas de API por minuto de la organización, viola límites de velocidad a nivel de entorno, excede límites de velocidad del perfil de seguridad o cuando la organización ha consumido su asignación mensual de visitas de API.

Además de los límites anteriores, la puerta de enlace de API en la nube administrada por Jitterbit aplica 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 colectivamente en todos los tipos de API, incluidas las API personalizadas, las API proxy y las solicitudes de OData. Este límite no se aplica a las puertas de enlace de API privadas, donde el rendimiento se determina según la capacidad del servidor host.

Compresión de carga útil

Las API de API Manager admiten la compresión gzip de la carga útil de respuesta. Para solicitar una respuesta comprimida, incluye el encabezado de solicitud Accept-Encoding: gzip en la llamada de API. La puerta de enlace de API devuelve la carga útil comprimida con gzip e incluye el encabezado de respuesta Content-Encoding: gzip. Solo se admite la compresión gzip.