• 人気コメント
  • 新着コメント
  • すべてのブックマーク
  • このページの情報

先月、ぐるなび APIリリースされていました。 ぐるなびさんの持っている膨大なデータベースWeb API を通して気軽にア クセスできるようになったのは、非常に喜ばしいし、その英断に感謝したいと 思います。 しかし、Web API 仕様書、特にエラー仕様を見てちょっとがっかりしました。 もう少し上手にデザインすれば、もっとよかったのに…、という思いです。 一度出してしまった API はそう簡単に変えられないと思いますが、 参考までに僕だったらどうするか、を書いてみます。 この仕様の一番の問題はエラ... > このページを見る

▼ ブログで紹介する
最終更新: 2007/06/18 19:27
  • hiroomi
    標準とのすり合わせ。2011/06/18
  • kamataro
    "エラーメッセージを出すためだけであれば、メッセージそのものをプレーンテキストで返せばいいのです。" / http://blog.rettuce.com/javascript/twitter_api-suppress_response_codes/ のような件にも注意2011/02/23
  • kaw0909
    2007年の記事。ぐるなびのAPI設計はエラーコードを再発明している。2010/06/18
  • ussy00
    エラーコード status code 400←validate error2008/10/20
  • webmarksjp
    dev2008/07/14
  • komagata
    APIのエラー設計に悩んでたので参考にしよう。2008/03/13
  • N_O_T
    自戒。2007/10/15
  • naoya_nakazawa
    API でも、正しく HTTP ステータスコードを使いましょうという話2007/09/26
  • hiromark
    確かにそう思う。2007/08/19
  • japanrock
    6042007/07/02
  • wacky
    Web APIにおけるエラーコード再発明の問題。ぐるなびの例。『単なるHTTPクライアントではなく、ぐるなびのエラーコードを実装した専用クライアントが必要になってしまう』2007/06/25
  • sho
    正解と言い切れないとは思うが、美しい実装のアイデアではある2007/06/24
  • ymorimo
    エラーにはコードを振らないと気が済まない人、たくさんいそう2007/06/22
  • oooooooo
    エラーコードの再発明2007/06/22
  • hiby
    宗教論争に発展。2007/06/20
  • ustar
    ぐるなびAPIの設計2007/06/20
  • ag-commerce
    なぜエラーコードの再発明は駄目なのでしょうか。それは専用のクライアントが必要になるからです。単なる HTTP クライアントではなく、ぐるなびのエラーコードを実装した専用クライアントが必要になってしまうからです2007/06/20
  • rhosoi
    つーかさ、フツーのwebページで言える。「削除されました」とか「見つかりませんでした」ってのは、200じゃなく2007/06/20
  • ore_de_work
    HTTPだけじゃないゾ> 000~鯖間内部用, 100~案内, 200~正常RES,300~エラーRES(クライアント 即時復旧可能) , 400~エラーRES( クライアントの要求変更必要), 500~サーバエラー(クライアントじゃ復帰無理)/ まー仕事だと600も有w2007/06/20
  • ultraist
    HTTPの上に定義している別プロトコルのようだからHTTPのステータスコードは関係ないのでは。HTTPのエラーが原因でTCPレベルのRSTを送ったりしないでしょ。HTTPで400ではないパラメータエラーで400を返すほうがおかしいのでは2007/06/20
  • FOCKER
    api 設計2007/06/19
  • raitu
    ぐるなびAPIのHTTP Status Codeがなんか変だという話2007/06/19
  • deflis
    エンジニアとして考えさせられる内容。2007/06/19
  • send
    すばらしい2007/06/19
  • sampaguita
    "もし、この二つを区別する理由が、エラーメッセージを出すためだけであれば、メッセージそのものをプレーンテキストで返せばいいのです"2007/06/19
  • convivial
    ごもっとも2007/06/19
  • nsta
    ぐるなびAPIを例にした『悪例』/エラーメッセージはプレインテキストで2007/06/19
  • i_say_tech
    ぐるなびAPI2007/06/19
  • kmachu
    SOAPなんかも再発明しちゃってるんだよね。欲張りすぎたか。2007/06/19
  • naonos
    本文とコラムが同じくらいのページ数という、一時期の JavaWorld の檜山さんみたいな構成2007/06/19

このブックマーク一覧を非公開にするには?

ユーザーはみんなでブックマークを共有して、効率良く情報収集しています。あなたもはてなブックマークを始めてみませんか?

関連商品