ウェブ API の設計に携わっている方であれば、API で使う URL のスタイルに統一的な考え方がないことも、選択した URL スタイルが API の使いやすさや寿命に大きな影響を与えることも、よくご存じでしょう。Google Cloud の Apigee チームは、社内だけでなくお客様とも協力しながら、API の設計について長く検討を行ってきました。本稿では、私たちが設計の現場で実際に使用している URL のデザイン パターンと、それを使う理由についてシェアしたいと思います。 著名なウェブ API をご覧になれば、いくつかの異なる URL パターンがあることに気づかれるはずです。次に示すのは、極端に異なる考え方に基づいた 2 つのスタイルの具体例です。 https://ebank.com/accounts/a49a9762-3790-4b4f-adbf-4577a35b1df7 htt

ルーティングルールのresourcesやmemberなどでURLに:idを伴うときに、多くの場合PrimaryKeyを使ってしまいがちですが、将来、要望として任意の文字列で代用したい。なんてことが考えられるので、簡単に修正ができるように備えておきます。 URLに:idを含むとき。

Webアプリケーションについて、RESTfulなURL・リソース設計のパターンを見出すことで、 どのパターンかを判断するだけで、既存の Good Practice が適用できる 名前をつけて呼べるようにしたい Railsなどのフレームワークで簡単に適用できるようにしたい ということを目指しています。 ほんとうに役立つか これはパターンと言えるのか もっと他にもある だいぶ粒度がバラバラ 名前の付け方（パターンは名前重要） など、ぜひご意見をください。 パターン Collection & Member Resource パターン Singular (Singleton) Resource パターン Filtered Collection パターン Filtered Subresource パターン Multi-member Resource パターン Partial Resource パター

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

WebAPIまたはWebサービスを作るときに、考えないといけないのがURL設計です。 近年は「Cool URL」と称して、短いURLを設計するのが流行りです。例としては、twitterの各ユーザーページのURLは「/user?user={ユーザーID}」などではなく、「/{ユーザーID}」になっています。 例：http://twitter.com/Hiraku 究極に短いURLですね。 ただ、ここまで短くしてしまうと困ることがあります。 twitterの場合だと、検索用のURL「/search」やオプション設定の「/settings/...」などは特例であり、ユーザーIDを指していません。これは、searchやsettingsという名前のユーザーを作ることができないことを意味します。拡張性が犠牲になってしまったんですね。。。 twitterほど極端なURL設計にせず、わかりやすく、自然に設

2.  @Hiraku (中野 拓) ◦ PHP歴5年ぐらい ◦ Zend Framework, Yaf ◦ http://blog.tojiru.net/ ◦ https://github.com/hirak 4.  http://example.com/index.php?action=hoge とかだとダサい  短くてCoolなURLにしたい http://twitter.com/Hiraku  しかし短すぎると 将来の拡張性が…  SEO対策がどうとか

JavaScriptで実装したのがdraftレベルのしか見つからなかったので作ってみました。 (↑Lv4まで対応してるのが有りました。でもせっかく作ったので引き続き公開しておきます。) URI Templateって？ 簡単に言うとURIに特化したテンプレートエンジンです。 「http://www.example.com/users/{userid:1}/{userid}/」って書いといて「http://www.example.com/users/t/test/」って文字列作れたら便利だよね！？ 詳しくは以下を参考にしてください。 RFC 6570 - URI Template 3分間・URIテンプレート - 檜山正幸のキマイラ飼育記 (はてなBlog) URI Templates の各言語実装 - Mi manca qualche giovedi`? 以下からお持ち帰りください。 gith

一時期（2010年の1月頃）、URLの議論をしていて、僕は拡張子を含むURLやクエリパラメータを擁護していました。 そろそろ決着、HTTPメソッド、URL、そして標準化された動詞 RESTfulなWebサイトと拡張子を含むURLについて 最近、またURLの問題を考えてみたのですが、僕が拘っているのは次の2点なのだと気付きました。 すべてのURLを列挙したい。 すべてのURLを分類したい。 すべてのURLを列挙したい あるWebサイトやWebアプリケーション（以下、総称してWebシステム）を考えたとき、有効なURLを完全に列挙したいのです。ここでの「URL」は、正確に言えばクエリパラメータを含まないパス部分のことです。もちろん、有効なURLは時々刻々と変化します。でも、ある一時点を取れば、その時点におけるURLは確定するはずです。各時点ごとのURLの集合を100%把握したいのです。 列挙する

Rails 3から resources というルーティング・ヘルパが用意されてRESTfulなURI設計に非常に役立ちます。 しかしながらサロゲートキーをプライマリキーに据える設計が主流のRails界隈において、データベースのプライマリキーをメンバURIのキーに採用するという戦略は /users/4 といった無味乾燥で、またわかりやすさに欠けるURIを生んでしまう弊害もあります。 たとえばユーザを表すリソースがあったとして、それらを一意に定めるのは名前が考えられます。 つまり /users/aereal や /users/aereal/edit といったURIで表現したいです。 RailsのRESTfulなパス・ヘルパ (user_path など) のうちメンバ・リソースに関するヘルパについてはオブジェクトを渡すと暗黙のうちに Object#to_param が呼ばれます。 これをオーバー

PHP の $_SERVER['REQUEST_URI'] と parse_url() の予想外な動作について。 - こせきの技術日記 の続き。 PHPのparse_url()は、 "/abc?a=x&time=09:00&x=y" はパースできるのに、 "/abc?a=x&time=09:00" だと失敗する。 相対URIで「動作しない」仕様だかららしいのだが、それはともかく、コロンのパーセントエンコードが必須なのか気になったので調べた。 URIの仕様 RFC 3986 まず、基礎となる URI の仕様 RFC 3986 がある。 RFC 3986 - Uniform Resource Identifier (URI): Generic Syntax Uniform Resource Identifier (URI): 一般的構文 日本語訳 RFC 1738 - A Gopher URL

Hashbang ConversationConvo with Dan Webb, a front end engineer at Twitter

はてなダイアリーやtDiaryの日記モード、1日のうちに複数投稿するとセクションで隔てられるけど、それを参照する有効なHTTP URLがないのがすごく不便。 セクションはひとつのリソースとして独立性が高いし、locatableであるべきだとおもう。 日記モード (日付ごとのリソースまでがlocatableで、セクションはlocatableではない) を使うメリットは薄いし、デメリットはとてつもなく大きい。 (有効なHTTP URLがないことによる損失をユーザもはてなも鑑みるべきでは……) crawlable-hashとかもdisられたけど、WWWの根幹を揺るがすような変更には慎重になるべきだとおもう。

URL に日付が入っていること。 http://onishi.hatenablog.com/entry/2011/11/07/172716 はてなダイアリーと比べてどっちが優れてるかは、はてなブログを使ってないのでわかりません。テキストエリアの広さが同じくらいだったら同点くらいじゃないかなと思う。