---
title: "Fehlerbehebung der API-Authentifizierung"
slug: "troubleshooting-api-authentication-errors"
updated: 2026-07-27T05:02:24Z
published: 2026-07-27T05:02:24Z
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.

# Fehlerbehebung der API-Authentifizierung

### 403-Fehler bei Verwendung von Try It!

**Wenn es eintritt:** Das Klicken auf Try It! auf einem Endpunkt zeigt sofort einen 403-Fehler zurück, nachdem eine Spezifikation erfolgreich hochgeladen wurde.

![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)

**Warum es passiert:** Der Spezifikation fehlt eine Definition für den Sicherheitsmechanismus `BearerAuth` unter `components/securitySchemes`.

**Wie man es behebt:**

1. Überprüfen Sie Ihre Spezifikation für eine Definition des Sicherheitsschemas `BearerAuth` unter `components/securitySchemes`.
2. Wenn es fehlt, fügen Sie es hinzu:

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

1. Lade die Spezifikation erneut hoch.
2. Während des Imports prüfen Sie den **Abschnitt Warnungen** im Zusammenhang mit der Inhaber-Authentifizierung und adressieren Sie diese.  

![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 Unautorisierter Fehler durch falsche Server-URL

**Wenn es eintritt:** API-Anfragen geben eine 401 Unautorisierte Antwort zurück, wenn Sie Try It! verwenden oder direkte API-Aufrufe tätigen.

**Warum es passiert:** Die falsche regionsbasierte Server-URL wird verwendet. Zum Beispiel führt das Senden einer Anfrage an `https://api.yourdomain.com` den richtigen Endpunkt `https://api.us.yourdomain.com` zu Authentifizierungsfehlern, da der regionsspezifische Endpunkt die Zugangsdaten unterschiedlich validiert.

**Wie man es behebt:**

1. Bestätigen Sie, dass Sie die korrekte regionsbasierte URL für Ihr Konto verwenden.
2. Stellen Sie sicher, dass die korrekte Client-ID und das Client-Geheimnis mit dieser URL verwendet werden.
3. Überprüfen Sie, ob das Authentifizierungstoken korrekt im Anfrage-Header enthalten ist.