Fehlerbehebung bei Pleo-API-Fehlern

Die Anfrage ist ungültig oder besteht die Validierung nicht.

• Lesen Sie den Antworttext, um fehlende Felder oder ungültige Werte zu identifizieren.
• Vergleichen Sie Ihre Anfrage mit der Endpunktdokumentation. Prüfen Sie die erforderlichen Felder, die Anfragestruktur, Datumsformate und zulässige Werte.
• Beheben Sie das festgestellte Problem und wiederholen Sie die Anfrage.

Die Anfrage konnte nicht authentifiziert werden.

• Stimmen Sie die Zugangsdaten auf die API und die Umgebung ab. Überprüfen Sie den Anfrage-Host anhand der Entwicklerdokumentation. Verwenden Sie Zugangsdaten für die neue API und die Legacy-API nicht gemischt. Dasselbe gilt für Staging- und Produktions-Zugangsdaten.
• Prüfen Sie den Autorisierungs-Header (`Authorization`). Neue API-Schlüssel verwenden die Basic-Authentifizierung, wobei der Schlüssel als Nutzername und ein leeres Passwort verwendet werden. OAuth-Zugriffstoken verwenden die Bearer-Authentifizierung. Befolgen Sie für Legacy-Token die Dokumentation zur Legacy-API. Entfernen Sie versehentliche Leerzeichen oder Zeilenumbrüche aus den Zugangsdaten.
• Prüfen Sie den Status der Zugangsdaten. Vergewissern Sie sich, dass sie nicht abgelaufen sind oder widerrufen wurden. Verwenden Sie für OAuth das Zugriffstoken – nicht das Aktualisierungstoken – und prüfen Sie, ob der Token-Aktualisierungsablauf funktioniert.

Die Anfrage wurde authentifiziert, aber der Zugriff ist nicht erlaubt.

• Prüfen Sie die Berechtigungsbereiche. Vergleichen Sie die Ihren Zugangsdaten zugewiesenen Berechtigungsbereiche mit denen, die vom Endpunkt benötigt werden. Wenn Sie diese nicht einsehen können, bitten Sie die Person, die die Zugangsdaten verwaltet, diese zu bestätigen.
• Prüfen Sie das Unternehmen und die Umgebung. Die Zugangsdaten müssen mit dem Unternehmen oder der Entität übereinstimmen, dessen bzw. deren Daten Sie anfordern, sowie mit der Umgebung, die Sie aufrufen.
• Prüfen Sie die Verfügbarkeit des Endpunkts. Vergewissern Sie sich in der Entwicklerdokumentation, dass der Endpunkt Ihre Authentifizierungsmethode und Ihren Anwendungsfall unterstützt.

Wenn diese Angaben übereinstimmen, der Zugriff aber weiterhin verweigert wird, kontaktieren Sie den Support, um den API-Zugriff des Unternehmens zu bestätigen. Geben Sie dabei an, ob dieselben Zugangsdaten bei anderen Endpunkten funktionieren.

Der angeforderte Endpunkt oder die angeforderte Ressource wurde nicht gefunden.

• Vergleichen Sie die Basis-URL, die API-Version und den Endpunktpfad mit der Entwicklerdokumentation.
• Bestätigen Sie, dass die Ressourcen-ID die Ressource identifiziert, die Sie anfordern wollten.
• Prüfen Sie, ob die Ressource zu dem Unternehmen und zu der Umgebung gehört, das bzw. die mit den Zugangsdaten verknüpft ist. Verwenden Sie IDs für Staging und Produktion nicht gemischt.

Eine Ressource kann den Status 404 zurückgeben, obwohl sie in Pleo existiert, wenn sie zu einem anderen Unternehmen oder einer anderen Umgebung gehört.

Die Anfrage steht in Konflikt mit einem bestehenden Vorgang oder Status.

• Lesen Sie die Fehlerantwort und prüfen Sie, ob derselbe Vorgang bereits übermittelt wurde. Überprüfen Sie die vorherige Antwort oder den daraus resultierenden Vorgang, bevor Sie eine erneute Anfrage senden.
• Befolgen Sie die Hinweise des Endpunkts zu Konflikten und Idempotenz in der Entwicklerdokumentation.

Ihre Schnittstelle sendet Anfragen zu häufig.

• Prüfen Sie die Antwort-Header auf Hinweise zu Wiederholungsversuchen oder Ratenlimits.
• Reduzieren Sie die Anfragehäufigkeit und vermeiden Sie sofortige Wiederholungsversuche in einer engen Schleife.
• Verwenden Sie ein exponentielles Backoff und befolgen Sie die Hinweise des Endpunkts zu Wiederholungsversuchen.

Wenn dieses Problem auch bei geringer Anfragehäufigkeit weiterhin besteht, geben Sie bei der Kontaktaufnahme mit dem Support Ihre Anfragehäufigkeit und das Verhalten bei Wiederholungsversuchen an.

Es ist ein serverseitiger Fehler aufgetreten. Erfassen Sie die Fehlerantwort und die unter „Benötigen Sie weiterhin Hilfe?“ aufgeführten Einzelheiten zur Anfrage und kontaktieren Sie den Support. Geben Sie an, ob der Fehler einmalig aufgetreten ist oder wiederholt auftritt.

Wenn Webhook-Ereignisse Ihre Schnittstelle nicht erreichen oder von ihr nicht verarbeitet werden:

• Erreichbarkeit prüfen. Ihr empfangender Endpunkt muss über HTTPS öffentlich zugänglich sein und darf Anfragen von Pleo nicht blockieren.
• Zustellungsprotokolle prüfen. Überprüfen Sie den Zustellversuch, den Antwortstatus und die Antwortzeit. Geben Sie zeitnah eine 2xx-Antwort zurück und beachten Sie dabei die Anforderungen der Webhook-Dokumentation.
• Signaturverifizierung prüfen. Verwenden Sie den Anfragetext, wie er in der Webhook-Dokumentation vorgeschrieben ist, einschließlich des Rohtexts, sofern angegeben.
• Doppelte Zustellungen sicher verarbeiten. Entfernen Sie Duplikate anhand der in der Dokumentation angegebenen Ereignis- oder Webhook-ID.

Prüfen Sie nach einer Änderung eine nachfolgende Zustellung. Falls diese weiterhin fehlschlägt, geben Sie bei der Kontaktaufnahme mit dem Support die Plangebühr-ID, die Ereignis- oder Webhook-ID, den Zeitstempel der Zustellung, den Antwortstatus des Endpunkts und bereinigte Protokolle an.