Dokumentation der REST Schnittstelle

Hi, gibt es eigentlich irgendwo einen vernünftige Dokumentation der REST Schnittstelle? Also nicht in diesem unsäglichen PHP Code sondern einfach in JSON wo man sieht was gibt die Schnittstelle aus und was erwartet sie? Sowas müsste doch von Anfang an beim API Design existieren. Ich bastel mir jetzt gerade diese Doku selbst zusammen indem ich den Quellcode des Shops lesen muss aber das kann nicht der Weisheit letzter Schluss sein.

Hier wäre ich auch stark interessiert! :smiley: