Fehlerbehebung

Voraussetzungen

Um Probleme bei der API analysieren und beheben zu können benötigen wir möglichst detaillierte Informationen darunter:

  • die Fehlermeldung, z.B. 401 - Unauthorized, 504 - Bad Gateway und wenn möglich und vorhanden der zurückgelieferte Body

  • bei Anfragen an die Endpunkte sowohl die URL, Input- sowie auch Output-Body müssen mitgeliefert werden in JSON oder als Screenshot

  • Datum und Uhrzeit wann der Fehler aufgetreten ist

  • Die Log-Dateien (beschrieben unten unter “Log-Dateien”)

Log-Dateien

Täglich neu geschriebene Log-Dateien ihrer API-Aufrufe finden sie unter “C:\ProgramData\Advo-web GmbH\Logs” bzw. “C:\ProgramData\advoware GmbH\Logs”. Dies sollte die erste Anlaufstelle bei Problemen mit API-Aufrufen sein. Insbesondere finden Sie aus Sicherheitsgründen nur hier weitere Informationen zu 401 Fehlern.

Forum für Release-Notes und generelle Fragen

Das Forum finden Sie unter https://forum.advoware.de/forum/api-bereich/faq/93229-getting-started#post93229. Hier können Sie Fragen zur Benutzung oder Problemen mit der API stellen.

Außerdem können Sie die Release-Notes auf Änderungen prüfen, die möglicherweise auftretende Fehler nach einspielen des Release Candidates erklären könnten.

Fehlermeldungen

00321 EXE VTL Insert/update value is too large

Eine Eigenschaft im JSON wird mit zu vielen Daten befüllt. Mehr Daten als für das Feld in der Datenbank vorgesehen ist. Hier bitte in Swagger das jeweilige Schema aufrufen und die maximale Länge (MaxLength) beachten.