API設計に関する10のワーストプラクティス | gihyo.jp

ソーシャル機能の実装など外部サービスのAPIを使ったアプリケーションが増える中、「⁠使いづらい設計のAPI」は、開発者にとっては頭の痛い問題ではないでしょうか？ Programable Web注1上に投稿されたAPIのワーストプラクティスに関する記事が国内外の開発者の目に止まり話題になっています。この記事によると悪いAPIに見られるプラクティスは次のようなものだそうです。 貧弱なエラーハンドリング HTTPのルールを無視したREST API 裏に潜んだ生のデータモデルの露出 セキュリティの複雑さ ドキュメント化されていない予期せぬリリース 貧弱なデベロッパエクスペリエンス MVC（Model-View-Controller）フレームワークが良いAPIにしてくれるという思い込み 開発すれば使ってもらえるとみなすこと 不十分なサポート 貧弱なドキュメント 自分自身のサービスがAPIを公開する場

[isseium]

リクエストパラメタの指定で、パラメタ間で組み合わせバリデーションが多発とか、そもそもリクエストパラメタが異常に多いとかね。自戒をこめて。