Moin!
Aktuell ist das ganze ja work in progess daher gibt es noch keine schriftliches Guidelines. Grundsätzlich sieht die Struktur so aus:
Alle Routen die auf Entitäten zeigen werden wie folgt aufgebaut:
/api/v1/product/
/api/v1/product/UUID/category
Diese Routen werden automatisch erstellt für alle Entitäten. Wenn man eine neue Entität anlegt, ist die direkt so erreichbar.
Will man nun einen Controller mit eigener Logik implementieren muss man natürlich aufpassen das man sich nicht mit den anderen Routen in die Quere kommt.
Daher sind solche Routen wie folgt definiert:
/api/v1/_action/database/migrate
Ein richtiges Beispielplugin welches auch aufs PHP Backend eingeht fehlt leider noch.