API設計：JSONとステータスコード

RESTfulに設計し、リソース指向のエンドポイントを定義。成功・失敗のレスポンスフォーマットを統一し、422等の適切なコードを返す。バージョニングで互換性を維持。Rate Limitと認可スコープで保護し、OpenAPIで仕様を公開すると連携がスムーズです。