Alle Artikel

Häufige REST-API-Fehler beheben

Situation

Bei der Arbeit mit der Wrike-API lassen sich Fehler nicht vermeiden. Sie können aus verschiedenen Gründen auftreten, wie z. B. unzureichende Benutzerrechte, Konto-Lizenzbeschränkungen oder falsche Formatierung. In diesem Artikel behandeln wir einige der häufigsten API-Fehler und stellen Schritte zur Fehlerbehebung bereit, damit Sie diese Probleme schnell erkennen und beheben können.

Wichtig

Überprüfen Sie immer noch einmal die API-Dokumentation.

Fehlerantworten

Das folgende Beispiel zeigt eine typische Fehlerantwort, die aus einer fehlgeschlagenen API-Anfrage resultiert.

Statuscode: XXX
Antwortinhalt:

{
\"errorDescription\": \"Lesbare Beschreibung des Fehlers.\",
\"error\": \"Kurzer, standardisierter Code oder Bezeichner für den aufgetretenen spezifischen Fehler\"
}

Statuscodes

300 - Mehrere Optionen

Mögliche Ursache

Falsche Basis-URL.

Schritte zur Fehlerbehebung

Prüfen Sie, ob Ihre Basis-URL korrekt ist.
Wrike speichert Kundendaten in mehreren Rechenzentren in den USA und der Europäischen Union. Um auf Ihre Daten zuzugreifen, verwenden Sie bitte die passende Basis-URL für den Standort Ihrer Daten. Sie können Ihre Basis-URL ermitteln, indem Sie die URL in der Adresszeile betrachten, wenn Sie Ihr Wrike-Konto in einem Browser öffnen.

400 - invalid_request

Mögliche Ursache

  • HTTP-Anforderungstyp ist ungültig, kritische Anforderungsdaten fehlen oder sind fehlerhaft (z.B. ohne Anhanganhang).
  • Der Header fehlt.
  • Der Name des Anfrageparameters ist ungültig.
  • Der Anfrageparameter wird für diesen Endpunkt nicht unterstützt.

Beispiel: Ein Benutzer versucht, den Parameter 'firstName' in einem GET/contacts-Aufruf zu verwenden

Schritte zur Fehlerbehebung

  • Prüfen Sie die API-Dokumentation, um sicherzustellen, dass Ihre Anfrage korrekt formatiert ist: Alle Parameter müssen gültig sein und vom Endpunkt unterstützt werden.
  • Stellen Sie sicher, dass alle erforderlichen Header in der Anfrage enthalten sind.

400 - invalid_parameter

Mögliche Ursache

  • Der erforderliche Parameter fehlt.
  • Der Parameterwert ist falsch ausgefüllt oder formatiert.

Schritte zur Fehlerbehebung

  • Überprüfen Sie die Dokumentation und stellen Sie sicher, dass alle als erforderlich gekennzeichneten Parameter in Ihrem Aufruf enthalten sind.
  • Stellen Sie sicher, dass der Parameterwert korrekt ist und gemäß der Dokumentation formatiert wurde.

400 - method_not_found

Mögliche Ursache

Es wird eine falsche API-Methode verwendet.

Beispiel: Ein Benutzer versucht, einen PUT/tasks-Aufruf zu senden, der nicht unterstützt wird. 

Schritte zur Fehlerbehebung

Stellen Sie sicher, dass die von Ihnen verwendete Methode für den Endpunkt unterstützt wird und korrekt gesetzt ist.

403 - not_allowed

Mögliche Ursache

Die angeforderte Aktion ist aufgrund von Lizenz-/Kontingentbeschränkungen usw. nicht zulässig.

  • Der Benutzer verfügt nicht über die erforderlichen Berechtigungen, um die angeforderte Aktion auszuführen.

    Beispiel: Ein Benutzer mit einem Business Plus-Abonnement ruft die Methode GET/data_export auf.

  • Das Konto verfügt nicht über die erforderliche Lizenz, um den Vorgang auszuführen.
    Beispiel: Ein Mitwirkender versucht, den Titel eines Ordners zu aktualisieren.

  • Die Operation kann nicht ausgeführt werden.
    Beispiel: Ein Benutzer versucht, eine bereits vorhandene Abhängigkeit zu erstellen.

Schritte zur Fehlerbehebung

  • Überprüfen Sie die Benutzerberechtigungen in den Wrike-Konto-Einstellungen. Stellen Sie sicher, dass der Benutzer über die erforderlichen Berechtigungen verfügt, um auf die angeforderte Ressource zuzugreifen.
  • Prüfen Sie die Lizenz des Kontos. Möglicherweise müssen Sie die Lizenz aktualisieren, um diese API-Methode nutzen zu können.
  • Überprüfen Sie, ob der Benutzer dieselbe Aktion in der Benutzeroberfläche ausführen kann.

404 - resource_not_found

Mögliche Ursache

  • Die angeforderte Ressource existiert nicht.
  • Der Benutzer hat keinen Zugriff auf die angeforderte Ressource

Schritte zur Fehlerbehebung

Überprüfen Sie die angeforderte Ressource und stellen Sie sicher, dass der Benutzer, dessen Token für die Integration verwendet wird, darauf zugreifen kann.

429 - too_many_requests

Mögliche Ursache

Die Anfragerate von derselben IP-Adresse (5000/Min.) oder die Anfragerate pro Benutzer (400/Min.) hat das Limit überschritten. Die ersten 400 Anfragen pro Minute werden bearbeitet, alles darüber hinaus führt zu Status 429.

Schritte zur Fehlerbehebung

  • Wenn Sie 429-HTTP-Antworten auf Ihre Anfrage erhalten, versuchen Sie es mit erneuten Versuchen unter Verwendung eines exponentiellen Backoff.
  • Verteilen Sie die Last auf mehrere Benutzer.
  • Wenn das Problem weiterhin besteht, kontaktieren Sie unser Support-Team

429 - rate_limit_exceeded

Mögliche Ursache

Das Ratenlimit wurde überschritten

Schritte zur Fehlerbehebung

Kontaktieren Sie unser Support-Team

500 - server_error

Mögliche Ursache

  • Der Server hat eine unerwartete Bedingung festgestellt, die ihn daran hinderte, die Anfrage auszuführen.
  • Der Benutzer hat keinen Zugriff auf die angeforderte Ressource

Schritte zur Fehlerbehebung

Leere Antwort

Mögliche Ursache

Sie versuchen, eine Ressource abzurufen, die nicht existiert.

Beispiel: Ein Benutzer sendet einen Aufruf, um Aufgaben aus einem leeren Ordner mithilfe des Aufrufs GET/folders/{folderId}/tasks abzurufen

Schritte zur Fehlerbehebung

Stellen Sie sicher, dass die Ressource (z. B. Aufgabe/Ordner/Projekt usw.) im Konto existiert.

Profi-Tipps

Ermitteln, zu welchem Konto Ihr Token gehört

Wenn Sie mehrere Wrike-Konten verwalten und sich nicht sicher sind, welchem Konto Ihr Token zugeordnet ist, ... Keine Sorge, das lässt sich leicht herausfinden. Führen Sie einfach den Aufruf GET/account aus, um dies zu bestätigen.

Den Besitzer Ihres Tokens ermitteln

Wenn Sie die API mit mehreren Benutzern getestet haben und den Besitzer eines bestimmten Tokens ermitteln möchten, gibt es einen einfachen und direkten Weg. Rufen Sie die Profilinformationen des Benutzers ab, indem Sie einen GET/contacts?me=true-Aufruf senden.

Support kontaktieren

Wenn weiterhin Hindernisse auftreten, kontaktieren Sie bitte unser Support-Team; wir helfen Ihnen gerne weiter.

Um die Lösung zu beschleunigen, geben Sie bitte die folgenden Informationen an:

  • Ihr Ziel mit dem API-Aufruf.
  • Die vollständige von Ihnen gesendete API-Anfrage.
  • Die Antwort, die Sie erhalten haben.
  • [Bei Berechtigungs- oder tokenbezogenen Problemen]
    Den mittleren Teil des Tokens, damit wir ihn auf unserer Seite dekodieren können.

    Nachfolgend finden Sie ein Beispiel für ein Zugriffstoken. Bitte senden Sie uns den zwischen zwei Punkten eingeschlossenen Teil (fett hervorgehoben) und lassen Sie die Teile vor und nach dem Punkt weg: 
    eyJ0dCI6InAiLCJhbGciOiJIUzI1NiIsInR2IjoiMSJ9.eyJkIjoie1wiYVwiOjM5MjA2MDIsXCJpXCI6NzIyMzMxOCxcImNcIjo0NjIwNzcwLFwidVwiOjY5NzA4NjcsXCJyXCI6XCJVU1wiLFwic1wiOltcIldcIixcIkZcIixcIklcIixcIlVcIixcIktcIixcIkNcIixcIkRcIixcIk1cIixcIkFcIixcIkxcIixcIlBcIl0sXCJ6XCI6W10sXCJ0XCI6MH0iLCJpYXQiOjE1OTk5MDk0MzV9.q3qOJs2swWSCgZl1ueKYsUyhME4RBD4cl53vZ0pwDcc

    Wichtig

    Senden Sie niemals das gesamte Token! Das Teilen Ihres permanenten Tokens entspricht dem Teilen Ihres Wrike-Kontopassworts.

Oben

Verwandte Beiträge