Гайд по параметрам HTTP (REST API) запросов, в которых чаще всего путаются новички:
👉 query — после ? в URL.
Используются для:
+ фильтров,
+ сортировки,
+ пагинации (limit+offset),
+ api-key (если так принято).
GET /users?name=Иван&limit=10&offset=20&order=name,asc
Получить список пользователей с именем "Иван", 10 записей, начиная с 20-ой, сортировать по алфавиту А -> Я.
Типичные проблемы:
• Отправляют бизнес-данные для создания/изменения в query, вместо использования тела json.
• Добавляют query в POST/PUT без причины.
👉 path — часть пути (эндпоинта).
Идентификатор конкретного ресурса.
GET /users/{userId}
→ GET /users/12345
Можно внутри пути, когда иерархия:
PATCH /users/{userId}/archive
Типичные проблемы:
• Отправляют ?userId=… в query, хотя это выбор сущности по id, а не фильтр.
👉 body — тело запроса json.
Сообщение, когда создаём/меняем данные.
Только для POST | PUT | PATCH.
Кроме json могут быть другие форматы.
{
"name": "Петр",
"lastname": "Иванов",
"bio": "Любитель системного анализа"
}
Типичные проблемы:
• Отправляют огромное количество параметров в query, которые там не помещаются, и могут быть обрезаны сервером при определенных настройках безопасности.
• Используют body(json) для GET или DELETE, где оно не поддержано.
В гайде:
✔️ название параметра и его определение
✔️ скрины из Postman
✔️ особенности
✔️ примеры
Изучайте, запоминайте и не путайтесь 🤝
#RestApiGA
📱 Tg | 💙 ВК | 💬 Max