Web API Design(その５) - winplusの日記
これApigee | Google Cloud Blogの勝手訳のつづき。 「クライアントがサポートするHTTPメソッドが制限されているとき」ですが、GETは冪等じゃなきゃいけないし、少なくともPOSTだろと思うのですが、GETしかできないクライアントを想定しているのかな。 例外的な振る舞いの取扱いのTips これまでのところ、ベースラインつまり標準的な振る舞いを取り扱ってきました。 ここでは、発生しうる例外のいくつかを調査するつもりです。Web APIのクライアントがいままで議論してきたことのすべてを取り扱うことができないときには、例外が発生します。たとえば、HTTPのエラーコードを横取りしてしまうクライアントがありますし、制限されたHTTPメソッドしかサポートしないクライアントもあるでしょう。 このような状況を取り扱うには、どんな方法があるしょうか？そして、特定のクライアントの制限のな
Web API Design(その４) - winplusの日記
これApigee | Google Cloud Blogの勝手訳のつづき。 属性の名前をどうするか 直前のセクションでは、フォーマットについて述べました。複数のフォーマットをサポートし、JSONを既定のフォーマットとして動作することを推奨しました。 こんどは、レスポンスを返すときに何が起こるのかを述べましょう。 データ属性をもったオブジェクトがあります。属性にどのように名前をつければよいのでしょうか? 主要なAPIからのAPIレスポンスをいくつか挙げます。 Twitter "created_at": "Thu Nov 03 05:19;38 +0000 2011": Bing "DateTime": "2011-10-29T09:35:00Z" Foursquare "createdAt": 1320296464 それぞれに異なったコード変換をつかっています。TwitterのアプローチはR
Web API Design(その３) - winplusの日記
これApigee | Google Cloud Blogの勝手訳のつづき。すべてをリソースとして扱うという原則のROAにたいして、リソースなしのレスポンスをどうするか、ときます。(その２)の「関連づけを単純化する」というセクションもふくめて、参考:URLに関する議論 -- なぜ僕はクエリパラメータを擁護、ときに推奨するのか - 檜山正幸のキマイラ飼育記 (はてなBlog)、それからいかにして合意と伝達の負担を減らすか： URLを例として - 檜山正幸のキマイラ飼育記 (はてなBlog)。 ページ送りと部分的なレスポンス 部分的なレスポンスにより、開発者に必要としている情報だけを提供することができます。 Twitter APIのツイート用のリクエストを例にしましょう。ふつうのTwitterアプリケーションがたいてい必要としているものよりも、はるか大量のものを手に入ります。個人の名前、ツイート
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
