駄目なAPI設計の中でI/Fの命名規則が定まっていない、駄目なパターンが割とある。
特に異なる言語を組み合わせたとき。
利用が多いから、目立つのはJSON。
駄目な例
手抜き、またはAPI都合の押し付けパターン
- スネークケースを使う。
- DBのカラム名などをそのまま使う。
- APIが利用している言語の命名規則をそのまま使う。
利用側を考慮して使い分けるようなことを書いている人もいるが、不要な依存関係を作るのが好きそうなので、基本的な設計思想として論外。
JavaScript言語以外は変換処理が必要だから、面倒なのは分かる。
…が、言語選定の段階でそれも加味しておきなよ、って感じが。
単にキャメルケースが気に入らないなら、無理にJSONを使わなくて良いので、XMLでも独自フォーマットでも使ってください。
まともに考えていない、またはRESTfulの学習したことないパターン
- 命名に一貫性がない。
勉強しましょう。
