Rest API驗證/錯誤消息最佳實踐

Question

在以下情況下，對客戶端的最佳響應消息是什麼？

想象一下，我有一個名爲/ users的端點，客戶端可以通過PUT來更新用戶的某些屬性。

允許客戶端更新某些用戶屬性，但其他人沒有。 例如，客戶端可以更新名稱和birthDate，但他無法更新代碼和registerDate。

如果客戶端嘗試更新他不被允許的屬性，那麼對客戶端的最佳響應消息是什麼？

RESPONSE 1

400錯誤的請求

{ 
    「err」: 「You can’t update the properites: code and registerDate.」 
} 

RESPONSE 2

400錯誤的請求

{ 
    「err」: 「You can update only the properties: name and birthDate.」 
} 

即，我應該respon是他嘗試更新但他不能的屬性，還是隻迴應他可以更新的屬性？

另外，如何更好地瞭解最佳實踐以正確告知我的API可以返回的錯誤和驗證消息？有一些指導或書籍？

Answer 1

下面是關於服務的API的最佳實踐一個相當不錯的文章：http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api

至於你的問題，這是真正關心你的喜好作爲一個開發者。我只是建議記錄你的API非常好。