Solução de problemas de erros de autenticação na API

Erro 403 ao usar o Try It!

Quando ocorre: Clicar em Tentar! em um endpoint retorna imediatamente um erro 403 após uma especificação ser enviada com sucesso.

Por que isso acontece: A especificação está faltando uma definição para o BearerAuth mecanismo de segurança sob components/securitySchemes.

Como consertar:

1. Verifique sua especificação para uma BearerAuth definição de esquema de segurança sob components/securitySchemes.
2. Se estiver faltando, adicione:

   components:
     securitySchemes:
       BearerAuth:
         type: http
         scheme: bearer

3. Refaça o upload da especificação.
4. Durante a importação, verifique a seção de Alertas para quaisquer avisos relacionados à Autenticação do Portador e enderece-os.
   

401 Erro não autorizado de URL incorreta do servidor

Quando ocorre: As solicitações de API retornam uma resposta não autorizada 401 ao usar o Try It! ou ao fazer chamadas diretas da API.

Por que isso acontece: A URL do servidor baseada em região errada está sendo usada. Por exemplo, enviar uma solicitação para https://api.yourdomain.com quando o endpoint correto está https://api.us.yourdomain.com causará falhas de autenticação porque o endpoint específico da região valida as credenciais de forma diferente.

Como consertar:

1. Confirme que você está usando a URL regional correta para sua conta.
2. Certifique-se de que o ID do cliente correto e o segredo do cliente estejam sendo usados com essa URL.
3. Verifique se o token de autenticação está corretamente incluído no cabeçalho da solicitação.