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

# HTTP-Statuscodes

> HTTP-Codes, die mit einer Antwort zurückgegeben werden.

Fehler werden mit [Standard-HTTP-Statuscodes](https://tools.ietf.org/html/rfc2616#section-10) zurückgegeben.

Die Statuscodes sind wie folgt:

<ul class="custom-bullets">
  <li>1xx: Informational – Übermittelt Informationen auf Ebene des Transferprotokolls.</li>
  <li>2xx: Success – Die Anfrage war erfolgreich.</li>
  <li>3xx: Redirection – Der Client muss zusätzliche Schritte unternehmen, um die Anfrage abzuschließen.</li>
  <li>4xx: Client Error – Fehlgeschlagene Anfrage aufgrund eines Client-Fehlers.</li>
  <li>5xx: Server Error – Fehlgeschlagene Anfrage aufgrund eines Serverfehlers.</li>
</ul>

### 200 Success

Die Anfrage wurde erfolgreich ausgeführt.

### 400 Bad Request

Ein `400 Bad Request`-Fehler bedeutet, dass der Server die Anfrage nicht ausführen konnte. Die häufigste Ursache ist eine fehlerhafte Syntax in der Anfrage-URL oder im Body.

### 401 Unauthorized

`401 Unauthorized`-Fehler werden in der Regel durch ein Problem im Anfrage-Header Ihres API-Aufrufs verursacht, d. h. Sie haben keinen gültigen API Key verwendet, um den API-Aufruf auszuführen.

### 403 Access Denied

Wenn Ihre Anwendung einen API-Aufruf mit Ihrem API Key ausführt und die Anfrage nicht erlaubt ist.
Ein 403 kann auch zurückgegeben werden, wenn das [User Profile gesperrt ist](/multiple-users/manage-user-profiles#reactivate-a-suspended-user-profile).

### 404 Resource Not Found

Dieser Fehler tritt auf, wenn Ihre Anwendung versucht, eine API aufzurufen oder eine Entität abzurufen, die nicht existiert.

### 405 Method Not Allowed

Dieser Fehler weist darauf hin, dass die in Ihrer Anfrage verwendeten HTTP-Protokollmethoden nicht unterstützt werden. Prüfen Sie die Dokumentation der API, um die unterstützten Methoden zu sehen.

### 429 Rate Limit

#### Ratenlimits pro User Profile

Jedes User Profile hat ein Ratenlimit von 300 API-Anfragen pro 5-Minuten-Intervall. Sie können Ihre Nutzung des Ratenlimits über die Antwort-Header überwachen:

<ul class="custom-bullets">
  <li>`x-ratelimit-max`: Zeigt Ihre maximal zulässigen Anfragen pro 5-Minuten-Zeitraum</li>

  <li>
    `x-ratelimit-count`: Zeigt an, wie viele Anfragen Sie im aktuellen 5-Minuten-Zeitraum gestellt haben
  </li>
</ul>

<Info>
  Wir empfehlen, auf 429-Fehlerantworten zu prüfen. Wenn Sie einen 429-Fehler sehen, haben Sie Ihr Ratenlimit erreicht. Wiederholte Versuche, das Ratenlimit zu überschreiten, können dazu führen, dass das User Profile gesperrt wird.

  Erfahren Sie mehr über den [Umgang mit Ratenlimits](https://www.ayrshare.com/blog/complete-guide-to-handling-rate-limits-prevent-429-errors/) für mehrere User Profiles.
</Info>

#### Ratenlimits für Plattform-Analytics

HTTP `429` kann auch zurückgegeben werden, wenn ein soziales Netzwerk Analytics-Aufrufe für ein bestimmtes Konto drosselt – unabhängig von den Limits Ihres Ayrshare User Profile. In diesem Fall enthält die Antwort einen plattformspezifischen Ayrshare-Fehlercode (zum Beispiel [`code: 444`](/errors/errors-ayrshare#facebook-analytics-rate-limit) für Facebook-Analytics-Drosselungen pro Page). Prüfen Sie das Feld `code`, um ein Profil-Ratenlimit von einer plattformseitigen Drosselung zu unterscheiden, und wiederholen Sie den Aufruf mit Backoff, anstatt den Nutzer zum erneuten Verknüpfen aufzufordern.

#### Ratenlimits für das Löschen von User Profiles

Sie können 8 User Profiles pro Sekunde löschen. Bitte staffeln Sie Ihre API-Aufrufe, wenn Sie viele Profile auf einmal löschen möchten.

#### Ratenlimit-Schutz und Sperrrichtlinie

Um die Integrität unseres Systems zu schützen, führen wir eine automatische Sperrung durch, wenn ein User Profile die Ratenlimits zu häufig überschreitet.
So funktioniert es:

Wenn Sie API-Anfragen stellen, müssen Sie das 5-Minuten-Fenster sorgfältig verwalten.
Wenn Sie beispielsweise 300 Anfragen in einer Minute stellen, müssen Sie vier weitere Minuten warten, bevor Sie zusätzliche Anfragen stellen können.
Jede Anfrage während dieser Wartezeit löst eine `429`-Fehlerantwort aus.

Wenn ein User Profile innerhalb eines Zeitraums von 24 Stunden 1.000 Ratenlimit-Verstöße (429-Fehler) ansammelt, wird das Profil automatisch gesperrt.
Nach Ablauf einer Wartezeit von 5 Minuten können Sie wieder Anfragen bis zum Standardlimit von 300 pro 5-Minuten-Fenster stellen.

### 500 Internal Server Error

Ein `500 Internal Server Error` weist darauf hin, dass Ayrshare einen internen Fehler hat oder die Verarbeitung fehlgeschlagen ist.