В каком формате передаются параметры в GET-запросе?

GET-запросы в протоколе HTTP используются для получения данных с сервера. Поскольку они не должны содержать тело (body), все дополнительные параметры, необходимые для уточнения запроса, передаются непосредственно в самом URL-адресе в специальном формате, называемом строкой запроса (query string).

Структура строки запроса

Строка запроса начинается с символа '?' после основного пути URL. Она состоит из одной или нескольких пар параметров в формате ключ=значение. Пары разделяются символом '&'.

https://example.com/api/users?name=John&age=30&city=New%20York

В этом примере передано три параметра: name со значением "John", age со значением "30" и city со значением "New York" (пробел закодирован как %20).

Кодирование параметров

Поскольку URL имеют строгий набор разрешённых символов (буквы, цифры и некоторые специальные символы), все недопустимые символы в значениях параметров должны быть закодированы с помощью процентного кодирования (percent-encoding). Например, пробел становится %20, символ '&' — %26, а '=' — %3D. В JavaScript для этого используют функции encodeURIComponent().

// Пример кодирования параметра в JavaScript
const searchTerm = "coffee & tea";
const encodedTerm = encodeURIComponent(searchTerm); // "coffee%20%26%20tea"
const url = `https://api.com/search?q=${encodedTerm}`;

Где и как применяется

Передача параметров в query string — стандартный способ для:

• Фильтрации, сортировки и пагинации данных в RESTful API (например, ?page=2&limit=20&sort=name).
• Поисковых запросов.
• Передачи идентификаторов сессий или токенов (хотя для чувствительных данных это небезопасно).
• Создания ссылок, которыми можно поделиться, с предустановленными параметрами.

Важное ограничение: длина URL ограничена браузером и сервером (обычно несколько тысяч символов), поэтому для передачи больших объёмов данных следует использовать POST-запрос с телом.

Итог: Формат строки запроса — это простой и универсальный механизм для передачи небольших, несекретных параметров в GET-запросах, фундаментальный для построения читаемых и отлаживаемых веб-интерфейсов и API.