🔥 Подвохи в REST API: разбор типовых ошибок🔥🙃

На этой неделе я публиковала задачи по REST API и просила вас проголосовать за правильные ответы.

📌 Если вы их пропустили, то сначала решите задачи здесь, а затем вернитесь к этому посту за разбором.


Типичные ошибки:

👉1) Список вакансий
Разбор тут

👉2) Просмотр вакансии
• Передавали jobId вакансии в query-параметре, хотя корректнее в path - это самая распространенная ошибка ❗️ Query-параметры для фильтров и сортировок списков.
• Добавляли details в URL — это лишнее, если уже есть {jobId} в path-параметрах
• Немногие попались на подвох с доменом api.com (3%)

👉3) Создание вакансии рекрутером
• ❗️ В URL добавляли create при POST — лишнее (“масло-масляное”). Это самая распространенная ошибка
• В варианте A, где указано recruiter (название каталога api?), желательно перенести название каталога api до версии, хотя и так допустимо
• ❗️Передавали jobId при создании вакансии — обычно он генерируется на сервере после её создания, поэтому в запросе его быть не должно (вариант I, распространенная ошибка).
• Потерян указатель на каталог API, но это не критично.


👉4) Отклик кандидата на вакансию
• ❗️В URL добавляли create при POST — лишнее (“масло-масляное”).
• PATCH для частичного редактирования данных, но не для создания отклика (C = 10%).
• В сущностях не рекомендуется указывать глаголы, если это не метод редактирования PATCH (D, H).
• Подставляли в URL id кандидата, хотя его лучше было бы отправить в тело, так как в предложенных вариантах до {candidateId} нет /candidate, чтобы мы в целом имели право его прописывать (F, G). Популярная ошибка ❗️


👉5) Изменение статуса отклика
• "Масло-масляное" с глаголом update/change и методами на изменение PUT/PATCH (C, H, J)
• Путаница с пониманием PUT и PATCH. PUT - полное редактирование, PATCH - частичное редактирование ресурса, когда надо перезаписать одно поле у сущности в БД, а не все.


👉 Подробно все ошибки указала на картинках к посту.


Вопросы?
Пишите в комментариях.


Изучайте разбор и запоминайте ошибки.

Для собеседований такая практика 100% пригодится 🤝

#RestApiGA