Habe mit grossem Interesse die API quer durch getestet. Und zwar mit einer Mio-fach genutzten python library - auf der Seite sollte also alles tip top sein. Mir ist aufgefallen:
- Authorisierung nur mittels Basic Authentication, sogar ohne Password - keine state-of-the-art Authorisierung (wie OAuth2) verfügbar
- JSON nicht sauber implementiert (JSON muss in einen string umwandelt werden (post) und umgekehrt (get))
- Update nicht sauber implemtiert (verwendet POST statt PUT und PATCH, wobei alle alten Werte nochmals hochgeladen werden müssen - vergisst man ein Feld, ist der Wert für immer futsch)
- Manche Felder XML (obwohl es JSON problemlos täte) und zudem ist das XML nicht syntaktisch korrekt, so dass man es mit einer library lesen kann (z.B.
<?xml version="1.0" encoding="UTF-8"?><car><model>Volvo</model>/car>)
- DELETE nicht sauber implementiert, stattdessen POST mit ids als csv string.
Ist es geplant die API einen Schritt vorwärts zu bringen, z.B. eine api/v2 einzuführen? Aus meiner Sicht wäre das das Vordringlichste der ansonsten wirklich tollen Applikation! 😍😅
P.S. 2. bis 4. habe ich jetzt am Client programmiert (auch keine grosse Sache), aber das kann ja nicht Sinn der Sache sein ...
