---
title: "Resolución de errores de autenticación de la API"
slug: "troubleshooting-api-authentication-errors"
updated: 2026-07-27T05:02:52Z
published: 2026-07-27T05:02:52Z
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.

# Resolución de errores de autenticación de la API

### Error 403 al usar Try It!

**Cuando ocurre:** Al hacer clic en Pruébalo! en un endpoint, devuelve inmediatamente un error 403 después de que una especificación se haya subido correctamente.

![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 qué ocurre:** La especificación carece de una definición para el `BearerAuth` mecanismo de seguridad bajo `components/securitySchemes`.

**Cómo solucionarlo:**

1. Consulta tu especificación para una `BearerAuth` definición de esquema de seguridad bajo `components/securitySchemes`.
2. Si falta, añádelo:

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

1. Vuelve a subir la especificación.
2. Durante la importación, revisa la **sección de Alertas** para detectar advertencias relacionadas con la autenticación de portadores y dirígetelas.  

![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 Error no autorizado por URL incorrecta del servidor

**Cuando ocurre:** Las solicitudes de API devolven una respuesta no autorizada 401 al usar Try It! o al realizar llamadas directas a la API.

**Por qué ocurre:** Se está utilizando la URL del servidor basada en la región incorrecta. Por ejemplo, enviar una solicitud al `https://api.yourdomain.com` punto final correcto `https://api.us.yourdomain.com` causará fallos de autenticación porque el punto final específico de la región valida las credenciales de forma diferente.

**Cómo solucionarlo:**

1. Confirma que estás usando la URL regional correcta para tu cuenta.
2. Asegúrate de que se esté usando el ID de cliente correcto y el secreto del cliente con esa URL.
3. Verifica que el token de autenticación esté correctamente incluido en la cabecera de la solicitud.