POST-запрос: что это
POST-запрос отправляет данные на сервер в теле запроса, а не в адресе ссылки. Для заявок с длинными полями и секретными ключами это обычно удобнее и аккуратнее.
Определение
POST — HTTP-метод для передачи данных, которые сервер должен обработать: создать заявку, зарегистрировать пользователя. Данные уходят в теле запроса. Бывает три распространённых вида тела: форма (пары «имя=значение»), JSON и данные с файлами.
Пример из лидогенерации
Форма на вашем сайте отправляет данные на ваш сервер, а он делает POST на адрес приёма лидов сети, передавая JSON с телефоном, городом, меткой sub1 и полем info. Лидпульт принимает параметры из адреса, формы и JSON, в плоском виде или в формате Lead[…].
Чем отличается от GET
- Секреты и персональные данные не остаются в адресе, а значит не попадают в журналы доступа вида «адрес целиком».
- Размер тела практически не ограничен для обычных заявок.
- Браузер не повторяет POST незаметно при обновлении страницы: он спрашивает подтверждение.
Нюансы
Заголовок типа содержимого должен соответствовать телу: для JSON это application/json. Ошибка здесь приводит к тому, что сервер не видит параметры и отвечает bad_request. Повтор POST без apiid при сбое сети может создать дубль, поэтому идентификатор передают всегда.
Практический совет
При отладке сохраняйте тело запроса и ответ целиком вместе с заголовками. Часто причина ошибки в типе содержимого или в кодировке, а не в самих данных, и увидеть это можно только по полной записи.
Связанные понятия
Пара к GET-запросу. Работает внутри API, ответ приходит в формате JSON, защита от дублей — идемпотентность. Формат параметров смотрите в документации.
Вопросы и ответы
Что выбрать для трекера, GET или POST?
Если трекер умеет только подстановку в ссылку, используйте GET. Если есть выбор, POST надёжнее для длинных текстов и секретов.
Можно ли смешать параметры из адреса и из тела?
Лучше не смешивать: проще отладка, если все параметры передаются одним способом.