Accept ヘッダーでベンダー MIME タイプ標準を使用して、REST リソースの要求とバージョンを処理したいと考えています。いくつかのリソースの一連の get メソッドを公開します。1 つは検索などからリソースのすべてまたはサブセットの配列を返し、もう 1 つはキー値によって要求された場合に特定のリソースを返します。
配列
GET .../api/orders?orderDate=2016-01-01
Accept: application/vnd.company.orders.v1+json
シングル (OrderId = 12345)
GET .../api/orders/12345
Accept: application/vnd.company.order.v1+json
私の質問は、複数対単一の応答の MIME タイプに関する標準があるかどうかです。上記のように、配列レスポンスに対応する MIME タイプは複数形、単数形は単数形にすべきだと思います。つまり、注文対注文。
私はこれについて何も見つけることができなかったので、標準やドキュメントへの提案やリンクは素晴らしいでしょう、ありがとう。