ネストされたリソースのRESTful API

Question

私は2つのエンティティHotel,を持っています。各商人は多くのホテルを持つことができます。

/api/v1/merchants/{id}/hotels/{id}

をしかし、私はこの意味論と間違っているものを考えていた：今私はこのようなAPIエンドポイントを過ごしてい

/api/v1/hotels/{id}

後の1が短すぎます。

Answer 1

私の経験では、後者のほうが後で柔軟性が増すので、後者の方が望ましいです。 6ヶ月のうちに誰かが "こんにちは、私はAgrabaのすべてのホテルを調べることができるようになりたい"と言うつもりです。最初のURLスキームはそれを苦痛にさせます - 新しいエンドポイントを追加する必要があります。 2番目のURLスキームでは、クエリパラメータ：GET /hotels?location=Agrabaでサポートされています。

/merchants/{id}/hotelsをコレクションエンドポイントとして使用して、POST/DELETEを使用して特定の販売者からホテルを追加/削除することができます。

Answer 2

RESTでは、各URLは、単一のリソースを一意に識別する必要があります。

ホテルのidがグローバルにユニークである場合は、短いリンクの使用に問題はありません。ただし、ホテルID 1がマーチャント1とマーチャント2と異なる場合は、最初にURL（基本的にユニークな複合キー）を使用してください。