Modell REST Service

Question

Angenommen, ich habe einen Händler "Konto" ... Wir haben die typischen /api/v1/merchantaccountPOST, PUT und DELETE.

Jeder Händler kann mehrere Benutzer haben. Dies sind die Benutzer des Händlers, wie: Admins, Schreiber, Mitarbeiter, NICHT Käufer des Händlers.

erstelle ich den Händler Benutzer-Endpunkt unter: /api/v1/merchantaccount/user und biete PUT, POST, DELETE

Oder implementiere ich einen kompletten separaten Service: /api/v1/merchantuser

Auch wenn ich den Benutzer Händler authentifizieren soll ich getrennte erstellen Endpunkt oder gleich bleiben?

/api/v1/merchantaccount/user/authenticate

vs

/api/v1/merchantuser/autneticate

Answer 1

Ich denke, es gibt zwei verschiedene Begriffe hier im Spiel:

1. Der Name (Ressource) des Endpunkts: wenn das der einzige benutzerbezogene Ressource/Endpunkt, die Ihre API haben wird, dann sollte es User sollte gut sein.
2. Der Pfad, über den zugegriffen werden kann: Wenn das Use-Case-Szenario nur die Benutzer auf die Website/API und Login erfordert, dann gibt es keinen Grund dafür, dass sie die Entität MerchantAccount durchlaufen müssen (die Verbindung zwischen a Händler und ein Benutzer wird wahrscheinlich während der Registrierung eingestellt)