---
title: "Solução de problemas de erros de autenticação na API"
slug: "troubleshooting-api-authentication-errors"
updated: 2026-07-27T05:03:16Z
published: 2026-07-27T05:03:16Z
canonical: "docs.document360.com/troubleshooting-api-authentication-errors"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

![API request interface showing authentication, request, and response sections with status codes.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/1_Screenshot-Troubleshooting_api_403_error.png)

**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
```

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

![Error messages displayed during API reference import, highlighting invalid identifiers.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/2_Screenshot-Troubleshooting_api_invalid_bearerauth_definition.png)

---

### 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.