このRESTAPIのパラメーター値はどこにあるべきですか？その理由は何ですか？

Question

次のRESTAPIがあります： ジェネラコディセタグプレ

APIは、ユーザーMartinが何か言いたいことがあることをユーザーのリストに通知することを想定しています。通知されるユーザーのリストは、1から1000までさまざまです。1000人のユーザーのリストはどこにあるべきですか：クエリ文字列、HTTPヘッダー、またはリクエスト本文？なぜですか？

Answer 1

リクエスト本文。ヘッダーとクエリ文字列には、実際にはサイズ制限があることが多く、間違いなく1000個の識別子でヒットします。より理論的なレベルでは、リクエストの本文は、サーバーがPOSTを介して処理するエンティティである必要があります。ヘッダーは、そのエンティティに関するプロトコルレベルのメタデータ用です。つまり、エンティティ自体ではなく、エンティティの処理に役立つ情報です。クエリ文字列は、リソースの識別子の一部であり、そのリソースの表現でもありません。