microservices - 適切な API エンドポイント REST/RPC の定義

Question

exの注文書アイテム（つまり、POアイテム）識別子のリストを入力する請求書エンティティのマイクロサービスでAPIを開発しています。PO# + productIdentifier を一緒に使用して、POItem を一意に識別できます。API の応答は、各 PO アイテムの請求書の数量です。

入力モデル -

input GetInvoicedQuantityForPOItemsRequest {
    poItemIdentifierList : POItemIdentifierList
}

構造物

list POItemIdentifierList {
    
 member : POItemIdentifier

}

structure POItemIdentifier {

   purchaseOrderNumber : String,

   productIdentifier : Long

}

POItem の請求済み数量= その PO Item から作成された Invoice Items の数量の合計。

注: 1 つの PO を使用して、複数の請求書を作成できます。請求書は、複数の PO から作成できます。

私は REST にまったく慣れていません。これまでのところ、レガシー サービスで RPC エンドポイントを使用してきました。しかし今、REST 形式でエンドポイントを定義する新しいサービスを構築しています (たとえば、 CreateInvoiceがPOST /invoiceに変更されました) 。スタック オーバーフロー コミュニティから、REST エンドポイントを定義するための正しいアプローチについての提案が必要です。この API を RPC 形式のままにしておく必要があります。

レガシー システムでのこの API の RPC エンドポイント: POST /getInvoicedQuantityForPOItems

このための REST での最初の試みは、POST /invoice/items/invoicedQuantityForPOItems です。しかし、この URI は名詞のようには見えず、動詞です。