Was sind einige gute Ressourcen für die Entwicklung von RESTful Web Service Schemas?

Question

Also, ich bin dabei, eine brandneue REST WS API für meine Anwendung zu erstellen. Ich habe meine Hausaufgaben auf der technischen Seite gemacht und fühle mich ziemlich sicher, Wege/zu/Ressourcen.undTheisRepräsentationen einzurichten. Gibt es jedoch irgendwelche Vorschläge für gute Ressourcen für Prozesse, um diese Pfade zu entwickeln? Welche Methoden sollten da draußen sein, was sollte eine eigene Ressource sein usw.?

Ich erkenne, dass dies letztendlich an mir als Entwickler liegt, aber ich suche nach einer etwas solideren Methode als "Jot-down, was auch immer ich mir für eine Weile ausdenken kann, dann esse mein eigenes Hundefutter bis es perfekt ist . "

Ich denke, diese Art von API Design-Methodik würde nicht ausschließen REST aber das passiert nur der Kontext, in dem ich dealign bin mit jetzt. :)

Answer 1

Ich denke, dass ein guter Ausgangspunkt wäre, es aus der Sicht der Verbraucher des Dienstes zu betrachten. Ich würde vorschlagen, ein Buch über API-Design. Here's a starting point.

Answer 2

Bitte lesen Sie this article vom Typ, der REST über einige häufige Missverständnisse von REST-APIs erstellt. Insbesondere müssen Sie die Definition von URI-Konventionen außerhalb des Bandes als Teil Ihrer API vermeiden. verschachtelter/URIs/to/Ressourcen haben nichts mit REST zu tun, und auch eines ihrer Einschränkungen verletzt, wenn Sie mehr als nur einen Einstiegspunkt bieten URI als Teil Ihrer API.