Ir para o conteúdo

Gateways da API Jitterbit

Visão geral

Quando uma API Manager API é chamada, a conectividade com a API é habilitada através de um gateway da API. Os gateways da 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 da API:

  • Gateways da API em nuvem: Esses gateways são hospedados e gerenciados pela Jitterbit.

  • Gateways da 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 das suas APIs.

Cronograma de lançamentos e notas de versão

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

  • O gateway da API em nuvem é atualizado automaticamente seguindo o cronograma de lançamentos do Harmony.

  • Um instalador atualizado do gateway da API privado 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 da 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 versão do Harmony, cada tipo de gateway da API é incluído como um item separado na tabela de datas de lançamento no topo de cada página de notas de versão. Notas de versão individuais são listadas sob o cabeçalho Gateway da API, com qualquer aplicabilidade relevante a certos tipos de gateway incluída nas notas de versão.

Limites de requisições e tratamento de erros

Os gateways da API implementam limites de requisições e retornam os seguintes códigos de erro HTTP para os erros:

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, utiliza 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 à 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.