В общем, было бы здорово получить какое-то описание всех возможных ошибок, возвращаемых 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"}
.В документации об этом нет упоминания, но приложение должно понимать это и, возможно, воздерживаться от предоставления пользователю возможности упустить этот элемент в будущем.