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

Два часа ночи, у разработчика горит релиз, он подключает ваш 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" } Всё. Что не так, почему, что делать — ни слова. Он лезет в документацию,...

Хабр

🎉 New Blog Post: Sane API error handling with RFC 9457 Problem Details in Java https://mehmandarov.com/rfc-9457-problem-details-jakarta-ee/

#jakartaee #java #rfc9457 #api #rest

Sane API error handling with RFC 9457 Problem Details in Jakarta EE

A practical look at RFC 9457 Problem Details for HTTP APIs in Jakarta EE – a hand-made ProblemDetail + ExceptionMapper approach, the Zalando Problem library, and a short note on Quarkus and Spring.

Rustam Mehmandarov

RFC 9457 fixes API error responses.
Quarkus makes it practical.

This article shows how to:
• standardize API errors with Problem Details
• expose them cleanly in Swagger UI
• document business errors via stable type URIs
• avoid annotating every endpoint by hand

If you care about API contracts and developer experience, this is worth a read.

https://www.the-main-thread.com/p/rfc-9457-quarkus-api-error-handling-swagger

#Java #Quarkus #APIs #OpenAPI #RFC9457 #DeveloperExperience

Tired of vague 400 Bad Request in your APIs?

I wrote a hands-on tutorial on using RFC 9457 with Quarkus for structured, machine-readable error responses. Powered by the quarkus-resteasy-problem extension and Zalando’s Problem library.

https://buff.ly/FaOJ4bF
#Java #Quarkus #API #RFC9457