java - 安らかな Web サービスでキーと値のペアを公開する正しい方法は何ですか?

Question

安らかな Web サービスを構築していて、バックエンドがたまたまキーと値のペア オブジェクトを公開しています。たとえば、次のように言えます。

String value = transientObject.get("key");

現在、その URL は次のようになっています。

GET /transientObject/key

値を設定するには、次のようにします。

POST /transientObject/key

value体内に 渡します。

私の API には、複雑なオブジェクトを返したり受け取ったりする呼び出しが他にもたくさんありますが、これは明らかにそのパターンに適合しません。GET と POST が次のような新しいオブジェクトを返し、受け入れるように API を変更できます。

public class KeyValue {

    private String key;
    private String value;

}

これは私のAPIの残りの部分とより一貫性がありますが、この呼び出しを行うのが少し面倒になります.値を送信/取得できるときに、オブジェクトを構築/分解する必要があります.

現在の方法に固執するか、一貫性のためにオブジェクトを受け入れるように API を変更する必要がありますか?