一般に、特定のリクエストに対してAPIによって返される可能性のあるすべてのエラーのある種の説明を取得することは素晴らしいことです。これにより、実装の信頼性が大幅に向上し、ユーザーへのアプリケーションのフィードバックが向上します。
「リクエストがエラーコードxxxで失敗しました」だけでなく、ローカライズされたエラーメッセージをユーザーに表示する必要があると想像してください。
良い例はこのエラー{"error":"flattr_once","error_description":"You are not allowed to flattr this thing more than once this period","error_uri":"http:\/\/developers.flattr.net\/api"}です。ドキュメントにはそれについての言及はありませんが、アプリケーションはそれを理解する必要があり、将来的にこのアイテムをフラット化するオプションをユーザーに提供することを控える必要があります。
これは私がお世辞を言ったときに見つけたいくつかの応答です：
403{"error":"flattr_once","error_description":"You are not allowed to flattr this thing more than once this period","error_uri":"http:\/\/developers.flattr.net\/api"}
401{"error":"no_means","error_description":"You don't have any money to flattr with","error_uri":"http:\/\/developers.flattr.net\/api"}
{"error":"flattr_owner","error_description":"You are not allowed to flattr your own thing","error_uri":"http:\/\/developers.flattr.net\/api"}