Лидпульт

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-ссылке?

Только если ссылка вызывается с вашего сервера или трекера и не видна посетителю. В коде страницы её размещать нельзя.

Почему кириллица в ссылке превращается в странные символы?

Это процентное кодирование. Сервер раскодирует значения обратно, поэтому «Самара» дойдёт корректно.