rest - このリソースの正しい RESTful 呼び出し

Question

私は現在、既存のインフラストラクチャへの RESTful インターフェイスを設計しており、ある特定の側面に苦労しています。

でアクセスできるユーザーのコレクションがあり/users 、そのコレクションの要素は/users/1などでアクセスできます

ただし、各ユーザーには、アクセスできる必要がある友達のリストもあります。users/1/friendsここで安らかな電話をかけるでしょうか？1 人のユーザーのみに関連しているため、それ自体のコレクションになる資格はありません。

どんな助けでも大歓迎です

score 3 · Accepted Answer

RESTful 設計に関する限り、URI は自由に指定できます。ただし、インターフェイスに RESTful にアクセスできるようにするには、次のようにする必要があります。

<user>
    <name>Bob Smith</name>
    <link rel="friends" href="/peeps/1/amigos" />
</user>

間接的なレイヤーを追加することで、クライアントは友人のリストへのリンクを見つけることができ、その URI が何であるかはクライアントにとって重要ではなくなります。いつでも変更できます。

URI はサーバーの実装の詳細であり、クライアントはそれらに結合してはなりません。唯一の結合は、rels と media の種類である必要があります。

score 2 · Accepted Answer

/user/{id}/friends適切な識別子だと思います。もちろんも使用できますが/users/{id}/friends、個人的にはアイテムリソースとコレクションリソースを区別することを好みます。

score 1 · Accepted Answer

あなたのソリューションに問題があるとは思いません。それが表すものの URI として完全に適切な選択。

3 に答える 3