Ваше сообщение об ошибке читает уставший человек в два часа ночи

Два часа ночи, у разработчика горит релиз, он подключает ваш API — и получает в ответ голое «invalid_request». Что не так, почему, что делать — ни слова. Сорок минут гаданий и злое письмо в поддержку. Разбираем, как сделать опыт разработчика (DX) человеческим: как переписать ошибки по стандарту RFC 9457, но для живого человека; почему время до первого успешного вызова — главная метрика онбординга; и отчего предсказуемый, «скучный» API — это комплимент. С готовым шаблоном, который можно прикрутить к себе сегодня.

https://habr.com/ru/articles/1042850/

#api #dx #developer_experience #rest #обработка_ошибок #error_handling #RFC9457 #problem_details #ttfhw #онбординг_разработчиков

Ваше сообщение об ошибке читает уставший человек в два часа ночи

Два часа ночи. Разработчик подключает ваш API, у него горит релиз. Делает запрос и получает: { "error": "invalid_request" } Всё. Что не так, почему, что делать — ни слова. Он лезет в документацию,...

Хабр