タグ

RESTに関するhnittaのブックマーク (2)

  • yohei-y:weblog: HTTP ステータスコードを正しく使おう

    先月、ぐるなび API がリリースされていました。 ぐるなびさんの持っている膨大なデータベースに Web API を通して気軽にア クセスできるようになったのは、非常に喜ばしいし、その英断に感謝したいと 思います。 しかし、Web API 仕様書、特にエラー仕様を見てちょっとがっかりしました。 もう少し上手にデザインすれば、もっとよかったのに…、という思いです。 一度出してしまった API はそう簡単に変えられないと思いますが、 参考までに僕だったらどうするか、を書いてみます。 この仕様の一番の問題はエラーコードです。 以下は 2-2 のエラー仕様に記述されているサンプルです。 <?xml version="1.0" encoding="UTF-8"?> <gnavi> <error> <code>602</code> </error> </gnavi> タグが三つ(gnavi, erro

  • yohei-y:weblog: REST 入門(その1) はじめに

    » REST 入門 目次 REST は Apache 創始者のひとりであるロイ・フィールディングさんが、 彼の博士論文で提唱したネットワーク分散システム、特に WWW のアーキテクチャスタイルです。 WWW 技術はなぜ成功したのか、その特徴は何なのか、 ということについてソフトウェアアーキテクチャの観点から見直し、 そのあるべき姿について論じるための基礎的な資料となるものです。 REST は既存の Web アプリケーション(人間が使うサービス)だけではなく、 いわゆる Web サービス(機械が使えるサービス)のためのアーキテクチャスタイルでもあります。 いわゆる SOAP を使った Web サービスとはアーキテクチャが真っ向から対立するため、 REST と SOAP はしばしば対立軸で語られます。 残念なことに、日ではアーキテクチャスタイルとしての REST はあまり論じられてこなかった

  • 1