GET-запрос: что это
GET-запрос — самый простой способ обратиться к серверу: все параметры вписаны в адрес после знака вопроса. Его можно открыть в браузере или собрать в трекере из макросов.
Определение
GET — HTTP-метод, предназначенный для получения данных. Параметры идут в строке адреса в виде пар «имя=значение», разделённых амперсандом. Пример структуры: адрес, затем ?wmkey=…&offer_id=1&city=Самара.
Пример из лидогенерации
Трекеры чаще всего вызывают API сети именно GET-ссылкой: в шаблон подставляются макросы телефона, имени и меток. Лидпульт принимает лид и GET, и POST на адрес /api/lead, поэтому такая настройка работает без доработок.
Нюансы
- Адрес попадает в журналы серверов, прокси и историю браузера. Секретный ключ в такой ссылке нельзя показывать посетителям: вызывайте её только с сервера.
- У длинных ссылок есть ограничение по длине, поэтому большой текст (например, поле «info») надёжнее отправлять методом POST.
- Значения нужно кодировать: пробелы, кириллица и спецсимволы заменяются процентными последовательностями. Хороший трекер делает это сам.
- GET по смыслу не должен менять данные, но на практике многие сети, включая приём лидов, допускают это для удобства.
Как проверить
Соберите ссылку с тестовыми значениями и откройте её. В ответе вы увидите JSON с status и, при ошибке, code. Не гоняйте проверки на боевых телефонах реальных людей.
Практический совет
Удобный приём для отладки: соберите ссылку по частям, добавляя по одному параметру, и проверяйте ответ после каждого. Так сразу видно, какое поле вызывает ошибку, и не приходится гадать по общему сообщению.
Связанные понятия
Парный термин — POST-запрос. Оба используются в рамках API, а ответ приходит в формате JSON. Правила приёма описаны в документации.
Вопросы и ответы
Безопасно ли передавать apikey в GET-ссылке?
Только если ссылка вызывается с вашего сервера или трекера и не видна посетителю. В коде страницы её размещать нельзя.
Почему кириллица в ссылке превращается в странные символы?
Это процентное кодирование. Сервер раскодирует значения обратно, поэтому «Самара» дойдёт корректно.