APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight
ちょっと前にTwitterでAPIのバージョニングをどうやるかみたいな話をしていたのですが、そのへんもやもやしているので少し整理しておきたいなと。 APIのURLを/api/v1/*とかってやるの、やめたほうがいいとおもうんだけどなぁ。いざv2を作るとなったときに、大量のコピペが発生して後悔するよ、って伝えたい。— Kenn Ejima (@kenn) February 28, 2014 さて、これについて色々と異論・反論も含めた意見が出たのですが、まずは、大昔にURL方式（＝コントローラ分割）でやってきて後悔したぼくが、（5年ぐらい前から）現在はどうやってAPIのバージョンを管理しているか？について紹介します。 基本原理としては、コピペが多発する根っこで分岐（＝コントローラ分割）じゃなくて、必要最小限のところで限局的に分岐するのがいい、という考え方に基づきます。 一言でいうと、「パラメー
Apiary - r7kamura per second
API(とそれに携わる開発者)の規模が拡大してくると、ドキュメントの整備や、仕様と実装の一貫性の維持、 クライアントとの知識の共有など、考慮すべき問題が沢山出てくる。 これらの問題に対する現実的な解決策を探るため、 ApiaryというAPI開発支援用のサービスを簡単に俯瞰することにした。 ここでは紹介しないが、他に RAML、 JSON Schema、 Swagger、 WADL、 Autodoc などが関連するものとして挙げられる。 Apiary http://apiary.io/ Apiaryは、API Blueprintと呼ばれる言語でAPIのインターフェース仕様書を記述する、という開発方法を提唱している。 API BlueprintはMarkdownを拡張した言語で、特殊な記述を用いて幾つかのメタ情報を付与出来る形になっている。 Markdownを採用することで人間にとって読み書き
はてなフォトライフのAtomAPIをRubyでほげほげしてみた - Post-itみたいな
はてなフォトライフAtomAPIについてははてダキーワードを参照の事。 その1: net/httpで叩いてみる WSSE認証用のライブラリがあるので導入する。 sudo gem install wsee で、コードは以下。 require 'socket' require 'net/http' require 'rubygems' require 'wsse' #config uri = 'f.hatena.ne.jp' id = 'id' pass = 'pass' #wsse auth http = Net::HTTP.start(uri,80) res = http.get('/atom/feed',{'X-WSSE' => WSSE::header(id,pass)}) ここで指定してる /atom/feed は投稿された写真のうち最近のエントリをAtomフィードで取得するためのエ
Rest api - Redmine
Status legend: Stable - feature complete, no major changes planned Beta - usable for integrations with some bugs or missing minor functionality Alpha - major functionality in place, needs feedback from API users and integrators Prototype - very rough implementation, possible major breaking changes mid-version. Not recommended for integration Planned - planned in a future version, depending on deve
Redmine Client - Access the Redmine API in Ruby - Redmine Blog - The Official Redmine blog -
Redmine 1.0 will include a REST API so I've started to build a Rubygem to make accessing the API in Ruby easy. So far redmine_client has support for all of the current APIs in Redmine, including: Read/write support for Issues Read/write support for Projects Read support for News Installation is an easy gem install redmine_client and it's used just like ActiveResource. For example to change Issue #
Data API Developer's Guide: The Protocol - Google Calendar APIs and Tools - Google Code
Data API Developer's Guide: The Protocol Google Calendar allows client applications to view and update calendar events in the form of Google Data API feeds. Your client application can use the Google Calendar Data API to create new events, edit or delete existing events, and query for events that match particular criteria. There are many possible uses for the Calendar Data API. For example, you ca
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ruby-dmmを使ってDMMのAPIを用いてアイテム検索を簡単にしよう - Qiita
https://github.com/gitlabhq/gitlabhq/tree/master/doc/api