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.

Descargo de responsabilidad: Este artículo se generó mediante traducción automática.

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

Prev Next

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.

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.

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.