響應(yīng)錯誤的時,生成統(tǒng)一的、結(jié)構(gòu)化的錯誤信息。包含一個機器可讀的錯誤 id
,一個人類能識別的錯誤信息(message
),根據(jù)情況可以添加一個url
來告訴客戶端關(guān)于這個錯誤的更多信息以及如何去解決它,例如:
HTTP/1.1 429 Too Many Requests
{
"id": "rate_limit",
"message": "Account reached its API rate limit.",
"url": "https://docs.service.com/rate-limits"
}
文檔化客戶端可能遇到的錯誤信息格式,以及這些可能的錯誤信息id
。