Microsoftは、Microsoft REST API Guidelinesを発表しています。
でもRoy T. Fielding大先生は、大変不満のようですね。
@kragen Probably not. I have my own REST guidelines. Adobe has its own API guidelines. At some point, we need to publish a mix tape.
— Roy T. Fielding (@fielding) July 19, 2016
Royさんは、以前URIにバージョンを入れることは強く反対してきた経緯がありますからね。
My point was that there is no need to anticipate such world-breaking changes with a version ID. We have the hostname for that. What you are creating is not a new version of the API, but a new system with a new brand.
Microsoftのまとめは大変いい資料ですけど、名前はHTTP API ガイドラインの方が適切だそうです。
Comments