Что кладешь в body что нельзя положить в query-параметры при запросе?

Основные различия между телом запроса и query-параметрами

При проектировании API и отправке HTTP-запросов важно понимать, что класть в тело запроса (body), а что передавать через query-параметры. Основное различие заключается в семантике, ограничениях и практическом использовании.

Query-параметры: для идентификации ресурса

Query-параметры (после знака ? в URL) используются в основном для:

• Фильтрации, сортировки и пагинации данных
• Идентификации конкретного ресурса или его состояния
• Параметров, которые кэшируются вместе с URL

Тело запроса: для передачи данных

Тело запроса используется для:

• Сложных структур данных (JSON, XML, FormData)
• Конфиденциальной информации, которая не должна попадать в логи
• Больших объемов данных, превышающих ограничения URL

Что нельзя класть в query-параметры

1. Большие объемы данных

Query-параметры имеют жесткие ограничения по длине (обычно 2048 символов в URL), а тело запроса может содержать мегабайты данных.

2. Сложные вложенные структуры

В query-параметрах сложно передавать глубоко вложенные объекты или массивы. В теле запроса это делается естественно:

// ПЛОХО - query-параметры для сложной структуры
// /api/users?filter[name]=John&filter[age]=30&sort=name&order=asc

// ХОРОШО - тело запроса для сложной структуры
fetch('/api/users', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    filter: {
      name: 'John',
      age: { $gt: 25, $lt: 40 },
      tags: ['developer', 'senior']
    },
    sort: { field: 'name', order: 'asc' },
    pagination: { page: 1, limit: 20 }
  })
});

3. Конфиденциальные данные

Query-параметры видны в:

• Истории браузера
• Логах серверов и прокси
• Referer headers других сайтов
• Аналитике третьих сторон

// ОПАСНО - токен в URL
fetch('/api/data?token=eyJhbGciOiJIUzI1NiIs...')

// БЕЗОПАСНО - токен в теле или заголовках
fetch('/api/data', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer eyJhbGciOiJIUz...' },
  body: JSON.stringify({ token: 'secure_data_here' })
});

4. Файлы и бинарные данные

Query-параметры не поддерживают передачу файлов, изображений или бинарных данных.

// Невозможно через query-параметры
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('metadata', JSON.stringify({ type: 'image' }));

fetch('/api/upload', {
  method: 'POST',
  body: formData  // Тело может содержать файлы
});

5. Операции, изменяющие состояние (не GET/HEAD)

Согласно RESTful принципам и семантике HTTP:

• GET запросы не должны иметь тела (но могут иметь query-параметры)
• POST/PUT/PATCH для создания/изменения ресурсов используют тело

// НЕПРАВИЛЬНО - изменение через GET с query-параметрами
fetch('/api/users/123?action=delete')

// ПРАВИЛЬНО - изменение через метод с телом
fetch('/api/users/123', {
  method: 'DELETE'
  // Или для сложного обновления:
  // method: 'PATCH',
  // body: JSON.stringify({ status: 'inactive', reason: 'violation' })
});

Практические рекомендации

Когда использовать тело запроса:

• POST, PUT, PATCH запросы для создания/обновления ресурсов
• Сложные поисковые запросы с множеством условий
• Пакетные операции (batch requests)
• Загрузка файлов и бинарных данных
• Конфиденциальная информация (пароли, токены, персональные данные)

Когда использовать query-параметры:

• Фильтрация GET запросов (/api/users?status=active)
• Пагинация (/api/users?page=2&limit=20)
• Сортировка (/api/users?sort=name&order=desc)
• Поиск по простым критериям (/api/products?q=laptop)

Пример из реальной практики

Рассмотрим API для поиска недвижимости:

// Query-параметры для базовой фильтрации (кэшируемой)
const basicSearch = '/api/properties?city=NYC&minPrice=100000&type=apartment';

// Тело запроса для сложного поиска
const advancedSearch = {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    location: {
      city: 'New York',
      neighborhoods: ['Manhattan', 'Brooklyn'],
      coordinates: { lat: 40.7128, lng: -74.0060 },
      radius: 5 // км
    },
    filters: {
      price: { min: 100000, max: 500000 },
      amenities: ['parking', 'elevator', 'gym'],
      yearBuilt: { $gt: 2000 }
    },
    sort: { by: 'price', order: 'asc' },
    pagination: { page: 1, itemsPerPage: 20 }
  })
};

Вывод: Выбор между телом запроса и query-параметрами зависит от типа операции, объема данных, требований безопасности и семантики API. Тело запроса предназначено для передачи сложных, объемных или конфиденциальных данных, особенно в не-GET запросах, в то время как query-параметры оптимальны для простой фильтрации и идентификации ресурсов в GET запросах.