Standard-REST-API-Designkonvention

Question

Apropos strenger REST-API-Designkonventionen, kann eine einzelne Ressource mehreren Routen entsprechen.

Zum Beispiel habe ich die Routen:

http://www.example.com/registrations 
http://www.example.com/confirmations 
http://www.example.com/unlocks 

All diese Endpunkte Verwendung der Benutzerressource machen einen neuen Benutzer zu registrieren, um einen Benutzer mit Bestätigung Token bestätigen, und Entsperren einen Benutzer Unlock-Token verwenden.

Ist das richtige REST-Design?

Answer 1

Nun, es ist nicht falsch, aber obendrein werden Sie wahrscheinlich auch einen /user Endpunkt haben, also könnte es bessere Möglichkeiten geben, dies zu skalieren.

Zum Beispiel könnte der Unlock einfach ein PUT sein auf dem /user mit einem

{ 
    "state": "unlocked" //active, whatever 
} 

Ich weiß nicht, das volle Ausmaß Ihrer API, aber Sie können entweder mit http Verben spielen wie ich oder POSTing verschiedener Payloads an denselben Endpunkt (z. B. mit einem Bestätigungs-Token als Eigenschaft im Textkörper für die Registrierung und erneutem Verwenden dieses Endpunkts).