良いURIの設計とは


(Webを支える技術を読んで)WebサービスやWeb APIを作る上でのURI設計の指針についてまとめる。

  • URIにプログラミング言語依存の拡張子を使用しない(.rb,.jspなど)
  • URIに実装依存のパス名を利用しない(cgi-binなど)
  • URIに言語のメソッド名を利用しない
  • URIにセッションIDを含まない
  • URIはリソースを表現する名詞とする

上の例外として、1つのリソースが複数の表現を持つ時、拡張子をつけることは推奨される。

例) 
http://example.jp/resource.html
http://example.jp/resource.json

参考

Webを支える技術 -HTTP、URI、HTML、そしてREST