Спасибо за ссылочку. Очень интересно. Присоединюсь и буду благодарен если у кого-то есть еще что почитать по system design

Я думаю лучше здесь спросить https://t.me/FaangInterview так как в фаанге систем дизайн идёт как отдельный раунд интервью

https://github.com/abstractart/shorts/blob/master/engineering/system-design.md Я здесь собираю материалы которые нахожу в интернете, возможно что-то пригодится

Класс! Спасибо

Спасибо за ссылку

Привет всем! Вопрос такой - как православно вертать всякие ошибки в рест апи. Писать заголовок 200 и оформлять ошибку как json (описание всякое там, поля опять же) или возвращать http код типа 403?

зависит от типа ошибки

как вы делаете?

если это клиентская ошибка - 4** статусы

серверные ошибки - 5**

и body ответа (описание ошибки с кодом ошибки, таргетом и сообщением)

в классическом варианте возвращают заголовок http status code 4xx, 5xx
но без body это быстро становится неудобным, тк абсолютно неясно что произошло - может просто вебсервер прилег

поэтому лучше передавать json в body с детальным описанием ошибки

и по мне, так лучше возвращать 200 с телом result: {}, error: { code: 42, desc: ... } (по своему вкусу)
и чекать что error не пустой
и тогда статусы отличные от 200 сигнализируют, что что-то не так с веб-сервером, а не с приложением
что бы "почувствовать разницу" попробуйте написать обработчики then/catch для `$.ajax('/api/order/123')`и различить в них когда ошибка от приложухи, а когда от вебсервера

вот да, "статусы отличные от 200 сигнализируют, что что-то не так с веб-сервером, а не с приложением" смущают

422 отличный статус для ошибок

а вообще кстати сваггер не позволяет описывать несколько ответов со статусом 200

++

моя логика проста как палка - если веб сервер получил ответ от приложения, то ответить он должен 200, потому что это код ответа уровня http транспорта
а то что там была ошибка на уровне приложения транспорт волновать не должно

в конце концов - ответ 301 Redirect никто руками на уровне приложение не обрабатывает, а считает что это должен делать транспорт

поэтому интерфейс должен быть универсальным

result: { ... },
error: { ... },

и желательно чтобы в error тоже было универсально code:, desc:
а вот содержимое result может меняться в зависимости от эндпоинта