​​Возвращаем информативные ошибки API

"Ошибки в API — это не просто граничный случай. Это важная часть функциональности, и относиться к ним нужно как к ключевой функции, которую не стыдно показывать пользователям и документировать. Умение сообщать о сбоях ясно и кратко, возможно, важнее любого другого аспекта проектирования API.

Ошибки должны:
- Быть максимально подробными.
- Давать контекст: что именно пошло не так и почему.
- Помогать людям узнать больше о проблеме.
- Помогать программам понять, что делать дальше.
- Оставаться единообразными во всем API."

Читать статью