WebAPI The Good Parts 真新しい内容はないけどなんとなくでやりがちな部分に答えを出しているのがよかった。 WebAPIを作ったことはあるけど本気で設計を考えたことなかった、みたいな人にはいい一冊だと思った。 URLについて URLに大文字や小文字を混在させるべきではない 単語を繋げなくては行けない場合はハイフンがいい 個人的には_が一般的だと思うんだけど・・・・ パラメータやフィールド名で迷ったら、http://www.programmableweb.com/ で似たような事例の単語に合わせるほうが無難 searchという単語 リストの一機能として絞込を提供するならsearchというエンドポイントで切る必要はないね(リストに絞込機能をもたせればいいね) リストは全部返す、検索用はあくまでこれ、という立て付けであればsearchAPIを設けるべき 検索に find という
![WebAPI The Good Parts 読んで WebAPI設計する上で気になった点 - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/7fe2eab22c52f28cac99c634ab973df111a6abfb/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9V2ViQVBJJTIwVGhlJTIwR29vZCUyMFBhcnRzJTIwJUU4JUFBJUFEJUUzJTgyJTkzJUUzJTgxJUE3JTIwV2ViQVBJJUU4JUE4JUFEJUU4JUE4JTg4JUUzJTgxJTk5JUUzJTgyJThCJUU0JUI4JThBJUUzJTgxJUE3JUU2JUIwJTk3JUUzJTgxJUFCJUUzJTgxJUFBJUUzJTgxJUEzJUUzJTgxJTlGJUU3JTgyJUI5JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmcz1hOWE5NWFmZTQ0YzkzMDcwYWU0NGJhMTc3MmY0NmI1Zg%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBwZWthMiZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTM2JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9ZjA1ZjA3ZWU2YjFhMTI2NGZlMTc0NTZkNjk1ZGE2YTc%26blend-x%3D142%26blend-y%3D436%26blend-mode%3Dnormal%26txt64%3DaW4g5qCq5byP5Lya56S-R2FtZVdpdGg%26txt-width%3D770%26txt-clip%3Dend%252Cellipsis%26txt-color%3D%2523212121%26txt-font%3DHiragino%2520Sans%2520W6%26txt-size%3D36%26txt-x%3D156%26txt-y%3D536%26s%3D33931f7129422f9752cf071aeccb2354)