Neu JTL-Wawi REST-API – Performance & Monitoring

[wespread]

Hallo zusammen,

wir wollen die JTL-Wawi REST API nutzen, um Daten zwischen Wawi und JTL-Shop zu synchronisieren. Unter anderem möchten wir Rechnungen im Shop für Kunden anzeigen – dass das nicht längst eine Standard-Funktion im JTL-Shop ist, finde ich ehrlich gesagt ziemlich verwunderlich. Aber gut, dafür gibt es ja jetzt die API.

Dass der REST-Server self-hosted läuft und unsere Infrastruktur entsprechend performen muss, ist uns völlig klar. Was uns aber fehlt, sind Antworten auf grundlegende Betriebsfragen:

- Gibt es Rate Limits? Wie viele Anfragen verträgt der REST-Server?
- Gibt es einen Health-Check-Endpoint, um die Verfügbarkeit zu prüfen?
- Wo werden Logs geschrieben? Kann man Response Times o.ä. irgendwo einsehen?
- Wird man benachrichtigt, wenn der Server ausfällt, oder muss man das komplett selbst überwachen?
- Startet der Windows-Dienst (ab 1.10) automatisch neu bei einem Crash?
- Hat jemand Erfahrungswerte zur Performance bei größeren Datenmengen?

Kurz gesagt: Wie überwacht man das Ding vernünftig im Produktivbetrieb?

Uns ist bewusst, dass die API noch in der Beta-Phase ist. Aber die Developer Experience ist aktuell wirklich nicht benutzerfreundlich. Es fängt schon bei der Authentication an – die Scopes sind nicht mal vernünftig dokumentiert. Man muss sich alles zusammensuchen. Für ein neuen Produkt von JTL (was nicht mehr "EURE KOSTENLOSE WARENTWIRTSCHAFT" ist) hätte ich mir da deutlich mehr erwartet.

Hat jemand die API trotzdem produktiv im Einsatz und kann Erfahrungen teilen?

Danke schonmal!

 

[css-umsetzung]

Hat jemand die API trotzdem produktiv im Einsatz und kann Erfahrungen teilen?

Ja, z.B.: einer meiner Kunden nutzt diese mit meinem Formular-Manger mit dem integriertem Retouren Portal.
Die API läuft seit Wochen stabil und macht keine Probleme, der Kunde hat am Tag bis zu 50 angemeldete Retouren.

Die Zugriffe sind schnell, sind am Ende aber davon abhängig, von wo die Daten gezogen werden, hast du die WAWI bei dir, kann es länger dauern.
Bei den Retouren ist die Wartezeit, bis ich alle Daten aus der wawi hat, nicht anders als wenn ich ein normales Formular ausfülle und auf den Request warte.

Ich teste mit der API derzeit sehr viele Geschichten, für zukünftige Plugins und im Grunde ist das alles recht flott

Eine App zu Registrieren ist gar nicht mal so schwer, dass ist eigentlich recht gut dokumentiert, ich hab mir damals das zugehörige Video angeschaut und dann war eigentlich alles klar.

Du kannst in deinem Plugin ja einbauen, dass es dich benachrichtigt, wenn die API nicht erreichbar ist und ja es gibt auch eine Status Abfrage über die API.

 

[wespread]

Hey, danke für die Einblicke! Gut zu wissen, dass die API bei dir stabil läuft.

Ein paar Gedanken dazu:

Bei uns liegt die Wawi auf einem dedizierten ecomdata Cloud-Server, also an der Infrastruktur sollte es nicht scheitern. Latenz zum SQL-Server ist bei uns also minimal.

Bei den Retouren verstehe ich, dass eine einzelne Anfrage (z.B. Retoure anlegen) schnell geht. Aber wenn man z.B. Retourendaten im Shop anzeigen will, braucht man pro Bestellung mehrere Requests (Auftrag holen, Positionen holen, etc.). Da würde mich interessieren, wie sich das bei dir bei höherem Volumen verhält.

Zum Thema Dokumentation – klar, die App-Registrierung an sich geht schon. Aber dass man ein Video braucht, damit es "klick" macht, zeigt ja eigentlich, dass die Doku alleine nicht ausreicht.

Und noch eine Frage, weil du ja gerade am Retouren-Thema dran bist: Weißt du, ob JTL mit dem RMA-Template im Shop schon was plant? Im NOVA-Template gibt es ja bereits ein account/rma.tpl (https://gitlab.com/jtl-software/jtl...templates/NOVA/account/rma.tpl?ref_type=heads), sieht aber noch nicht aktiv aus. Wird das irgendwann nativ kommen, oder ist man da auf Plugins wie deins angewiesen?

 

[css-umsetzung]

dann wirst du mit den Antwortzeiten keine Probleme haben.

für eine Retoure müssen einige Requests zum abfragen der Daten durchgeführt werden, das läuft flüssig.
Ich habe wie angesprochen mehrere Dinge gemacht, auch ein abfragen von einer Artikelliste, ca. 800 stück, im jeweils 100er Pack war von der Zeit her OK

Das RMA im Shop wurde eingestampft, da wird nichts mehr passieren.

Man kann das auch ohne Video, ich habe es angeschaut, um nicht lesen zu müssen 🙂