rest - REST はすべてのレコードと 1 つのレコードを結合しました

Question

請求書を持つ REST エンドポイントを構築しています。すべての請求書の両方のリストを 3 つのレベルの説明で作成する必要があります (詳細はデフォルト、合計のみ、顧客情報を含むも​​の)。

また、より多くの情報を含む個々の請求書のエンドポイントを構築する必要があります。

私が考えていた

GET /invoices               <-- detailed
GET /invoices?mode=sums     <-- sums
GET /invoices?mode=customer <-- sums
GET /invoices/TNTV002793849 <-- individual invoice

しかし、他の人が2つの異なるものを実装しているのを見たことがあります

GET /invoices/detailed     <-- detailed
GET /invoices/sums         <-- sums
GET /invoices/customer     <-- sums
GET /invoice/TNTV002793849 <-- individual 

これらすべてがRESTをカウントできることを読んだことから、私はリンク付きのものを作成する必要があることをすでに知っています。

私の質問は、より実用的な観点からのものです。たとえば、実装がより簡単で、より安全で、慣例により一般的です。

私はおそらくサーバー用のFlaskでpythonを使用し、それが問題になる場合は、私が作成するクライアントの1つがJQueryになります。