RESTful API学習には以下の書籍がオススメです。やや古いけど間違いなしです。
オライリー「Web API: The Good Parts」
https://www.oreilly.co.jp/books/9784873116860/
個人的には、
・厳密なRestfulに従うのは難しいためRestishAPIから始めたほうが気が楽。
・操作アクションはHTTP動詞で表現、エンドポイントのリソースは名詞形で表現。
・OpenAPIでI/F定義しクライアントスタブ、サーバスケルトンを自動生成する。
・業界標準に従うのも重要だけどWebAPIのコンシューマーが使いやすいと思えるような格好のAPIであることの方が重要。
・WebAPIのコンシューマーの想定ペルソナ、どのような使わせたいのかのユーザーストーリーを基準に逆算してWebAPIのリクエスト・レスポンスを練っていくイメージ。
だと考えております。
あくまでも一意見ですが参考になれば幸いです。
返信 (1)
返信する(フォームを表示)
ログインしないと返信できません。
投稿日:2025-03-07 17:56:34
投稿ID:2607
いいね:1
やや日本語おかしかったので訂正。
◯
・厳密なREST原則に従うのは現実的ではないケースはあるor難しいため最初はRestishなAPIから始めたほうが気が楽。
Restish=あくまでもREST風なWebAPIのこと。
✕
・厳密なRestfulに従うのは難しいためRestishAPIから始めたほうが気が楽。
投稿日:2025-03-07 18:10:32
コメントID:3961