Todos os produtos
Search
Central de documentação

API Gateway:Solucionar erros na tabela de códigos de erro

Última atualização: Sep 09, 2026

API unsupport the channel

Causas

O esquema HTTP da solicitação é inválido.

Cada API oferece suporte a um esquema HTTP específico. Os provedores podem configurar uma API para permitir apenas HTTP, apenas HTTPS ou ambos.

API unsupport the channel: Uma solicitação HTTP foi enviada para uma API que oferece suporte apenas a HTTPS.

API unsupport the channel: Uma solicitação HTTPS foi enviada para uma API que oferece suporte apenas a HTTP.

Soluções

API unsupport the channel: Use HTTPS em vez de HTTP para chamar a API.

API unsupport the channel: Use HTTP em vez de HTTPS para chamar a API.

A403IS

Causas

A assinatura fornecida pelo cliente não corresponde à assinatura do servidor.

Soluções

Quando as assinaturas não correspondem, o API Gateway retorna a StringToSign do servidor no cabeçalho de resposta X-Ca-Error-Message.

A StringToSign contém a string usada para calcular a assinatura antes do envio da solicitação. Para obter mais informações, consulte Use digest authentication to call an API.

Compare sua StringToSign local com a retornada na resposta. Se você usou a demonstração oficial, recupere a StringToSign da classe de ferramenta de cálculo de assinatura.

Os cabeçalhos de resposta HTTP não aceitam quebras de linha; portanto, as quebras de linha presentes na StringToSign são removidas da resposta. Considere essa diferença ao comparar as strings.

Se as strings do cliente e do servidor coincidirem, verifique se o AppKey e o AppSecret são válidos. Por exemplo, confirme se contêm espaços extras.

Invalid Url

Causas

O método HTTP, o caminho ou o ambiente (X-Ca-Stage) na solicitação é inválido.

Por exemplo, a solicitação tem como alvo uma API no ambiente de teste, mas a API não foi publicada nesse ambiente.

Note:

  • Se você não especificar um ambiente na solicitação, ela será enviada por padrão para o ambiente de produção (RELEASE).

  • Ao modificar uma definição de API, republice-a para que as alterações entrem em vigor. Esse erro ocorre frequentemente quando o caminho da API é alterado, mas a API não é republicada.

Soluções

Verifique os três fatores a seguir em sua solicitação: método HTTP, caminho e ambiente.

  1. Use o mesmo método HTTP definido na API. Por exemplo, se uma API exige POST, não envie uma solicitação GET.

  2. Use o caminho de solicitação correto. Caso você seja o proprietário da API, republice-a após qualquer modificação.

  3. Especifique o ambiente no qual deseja chamar a API. Use o cabeçalho X-Ca-Stage na solicitação. Valores válidos: TEST, PRE e RELEASE, que indicam, respectivamente, o ambiente de teste, o ambiente de staging e o ambiente de produção. Se o cabeçalho não for especificado, a solicitação será enviada por padrão para o ambiente de produção.

Unauthorized

Causas

A aplicação não tem autorização para chamar a API.

Solução

Tente as seguintes soluções:

  1. Se você criou a API, crie uma aplicação no console do API Gateway e autorize-a a chamar a API. Uma aplicação é obrigatória até mesmo para testar sua própria API.

  2. Caso tenha adquirido a API, verifique a lista de APIs autorizadas na página de detalhes da aplicação. Se a API desejada não estiver listada, solicite autorização.

  3. Se a API pertencer a um parceiro, entre em contato com ele para obter autorização. Forneça o ID da sua aplicação (AppId) para que o parceiro possa autorizá-la.

  4. As autorizações são específicas por ambiente. Uma aplicação autorizada em um ambiente não pode chamar a mesma API em outro ambiente.

  5. Confirme se você está usando a combinação correta de aplicação e API. Incompatibilidades são comuns quando existem múltiplas aplicações ou APIs.

I403AA

Causas

A aplicação chamadora não possui as permissões de acesso necessárias para chamar a API de destino, o que causa falha na verificação de autorização.

O API Gateway retorna o código de status HTTP 403. O cabeçalho de resposta X-Ca-Error-Code é I403AA, e o cabeçalho de resposta X-Ca-Error-Message é Invalid App Authorization no permission.

Solução

No console do API Gateway, verifique se a aplicação chamadora possui as permissões de acesso necessárias para chamar a API de destino. Se a autorização estiver ausente, autorize a aplicação chamadora no console ou chame SetApisAuthorities para conceder as permissões de acesso necessárias. Em seguida, envie a solicitação novamente.