ソーシャル機能の実装など外部サービスのAPIを使ったアプリケーションが増える中、「使いづらい設計のAPI」は、開発者にとっては頭の痛い問題ではないでしょうか? Programable Web注1上に投稿されたAPIのワーストプラクティスに関する記事が国内外の開発者の目に止まり話題になっています。この記事によると悪いAPIに見られるプラクティスは次のようなものだそうです。
- 貧弱なエラーハンドリング
- HTTPのルールを無視したREST API
- 裏に潜んだ生のデータモデルの露出
- セキュリティの複雑さ
- ドキュメント化されていない予期せぬリリース
- 貧弱なデベロッパエクスペリエンス
- MVC(Model-View-Controller)フレームワークが良いAPIにしてくれるという思い込み
- 開発すれば使ってもらえるとみなすこと
- 不十分なサポート
- 貧弱なドキュメント
自分自身のサービスがAPIを公開する場合などは大いに参考にしておきたい項目ですね。
URL:http://blog.programmableweb.com/2012/08/03/top-10-api-worst-practices/
- 著者プロフィール
安藤祐介(あんどうゆうすけ)
下北沢OSS カフェの常連。今年はオープンソース博物館を企画したいです。
Twitter:yando
小倉純也(おぐらじゅんや)
QNYP, LLC. のプログラマ。今年はヨーロッパに行ってみたいですね。
Twitter:junya
溝畑考史(みぞはたたかし)
怒濤の新年ラッシュを過ぎてようやくまともなサンフランシスコ生活。
Twitter:beatak