RESTful APIはどの程度分離すべきですか？

以前にRESTful APIを作成したことはありませんが、RESTful APIをどの程度分離すべきか疑問に思っていますか？

たとえば、名前、住所、電話番号、メールアドレス、言語などを持っている顧客がいるとしましょう。

個々のフィールドを更新する方法（アドレスの更新、電子メールアドレスの更新など）があるのは理にかなっていますか、それとも顧客全体に対して単一の更新があり、各フィールドはオプションですか？

リソースに対して1つの更新アクションがあります。大まかな経験則として、データベース内のテーブルはリソースになります。したがって、この例では、1つの更新アクションを持つ顧客用のコントローラーが1つあり、フィールドは可能な限りオプションです。

これには例外があります（たとえば、パスワードとpassword_confirmationを期待するパスワードを更新する場合）が、これはほとんどの場合に当てはまります。

例外は、作成および破棄のみが可能なSessionsControllerなど、一部のリソースに対するアクションが制限されているコントローラーである可能性が高くなります。単一のフィールドに対してアクションが必要になることはほとんどありません。

あなたの例では、一つのことはそれ自身のリソースとして扱うことができ、それがアドレスです。住所のテーブルがある場合、特に顧客ごとに複数の住所がある場合（請求、配達など）、これはネストされたリソースとして処理できます。ただし、ここでもアドレスリソース全体に対して1つの更新アクションがあります。