Gateways da API Jitterbit

Visão geral

Quando uma API Manager API é chamada, a conectividade com a API é habilitada através de um gateway de API. Os gateways de API lidam com as tarefas de segurança envolvidas na aceitação e processamento de chamadas feitas a uma API Manager API.

Existem dois tipos de gateway de API:

Gateways de API em nuvem: Esses gateways são hospedados e gerenciados pela Jitterbit.
Gateways de API privados: Esses gateways são instalados, hospedados e gerenciados por você. Eles fornecem controle total sobre a autorização, roteamento, taxas e armazenamento e processamento de carga útil de suas APIs.

Cronograma de lançamentos e notas de lançamento

O cronograma de lançamentos para o gateway de API varia dependendo do tipo de gateway:

O gateway de API em nuvem é atualizado automaticamente seguindo o cronograma de lançamentos do Harmony.
Um instalador de gateway de API privado atualizado fica disponível na página de Downloads ao final do lançamento do Harmony e da atualização do Grupo de Agentes em Nuvem Sandbox.
A imagem Docker do gateway de API privado fica disponível no Docker Hub ao final do lançamento do Grupo de Agentes em Nuvem de Produção da região da América do Norte (NA).

Nas notas de lançamento do Harmony, cada tipo de gateway de API é incluído como um item separado na tabela de datas de lançamento no topo de cada página de notas de lançamento. Notas de lançamento individuais são listadas sob o cabeçalho Gateway de API, com qualquer aplicabilidade relevante a certos tipos de gateway incluída dentro das notas de lançamento.

Limites de solicitação e tratamento de erros

Os gateways de API implementam limites de solicitação e retornam esses códigos de erro HTTP para os seguintes erros. Limites adicionais em nível de plataforma podem se aplicar dependendo do tipo de gateway.

Código de erro HTTP	Descrição
`403 (Proibido)`	O gateway da API rejeitou a solicitação devido a permissões insuficientes ou falha de autenticação. Isso ocorre quando a solicitação não possui credenciais válidas, usa uma chave de API expirada ou inválida, viola restrições de endereço IP ou tenta acessar uma API sem a devida autorização através do perfil de segurança atribuído.
`404 (Não Encontrado)`	O endpoint da API solicitado não pôde ser encontrado. Isso geralmente ocorre quando a URL do serviço está incorreta, a API foi despublicada ou excluída, o prefixo da URL do ambiente é inválido ou há uma incompatibilidade na versão da API ou na raiz do serviço especificada na URL da solicitação.
`414 (URI Muito Grande)`	A URL do serviço da API excede o limite de 8.000 caracteres.
`429 (Muitas Solicitações)`	A solicitação é rejeitada devido a limitação de taxa. Isso ocorre quando a solicitação excede a permissão de acessos da API por minuto da organização, viola limites de taxa em nível de ambiente, excede limites de taxa do perfil de segurança ou quando a organização consumiu sua cota mensal de acessos à API.

Além dos limites acima, o gateway de API gerenciado pela Jitterbit impõe um limite de nível de plataforma de 200 solicitações de API por minuto por organização. Solicitações que excedem esse limite podem ser limitadas pela plataforma. Esse limite se aplica coletivamente a todos os tipos de API, incluindo APIs personalizadas, APIs de proxy e solicitações OData. Esse limite não se aplica a gateways de API privados, onde a capacidade de processamento é determinada pela capacidade do servidor host.