這個REST API的參數值應該在哪裏？爲什麼？

Question

我有以下的REST API：

POST /users/martin/notify/... 

的API是假設來通知用戶的列表，用戶馬丁有話要說。要通知的用戶列表可以從1個到上千個不等。千位用戶的列表應該是：Querystring，HTTP Header還是Request body？爲什麼？

Answer 1

請求正文。標題和querystrings在實踐中經常會有大小限制，你肯定會碰到一千個標識符。在更理論層面上，請求主體應該是希望服務器通過POST處理的實體。頭文件用於協議級別關於該實體的元數據;即幫助處理實體的信息，而不是實體本身。查詢串是該資源的標識符的一部分，也不是該資源的表示。