雪泥鴻爪--IT技術者の随筆

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 ガイドラインの方が適切だそうです。