Лидпульт

REST: что это

REST — стиль построения интерфейсов, при котором каждый объект (заявка, оффер, клиника) имеет свой адрес, а действие выбирается HTTP-методом: получить, создать, изменить, удалить.

Определение

REST (передача состояния представления) — набор принципов, по которым строят веб-API. Главная идея: адрес указывает, с чем работаем, а метод запроса — что делаем. Сервер не помнит предыдущие запросы: каждый содержит всё нужное для обработки.

Как это выглядит

Допустим, вы получаете список заявок: метод GET на адрес со списком. Создаёте заявку: метод POST с данными. Ответы приходят в виде JSON, а результат отражает HTTP-код: 200 — успех, 4xx — ошибка отправителя, 5xx — сбой на стороне сервера.

Пример из лидогенерации

Приём заявки в Лидпульте устроен проще классического REST: достаточно одного адреса, который понимает и GET, и POST, а параметры можно передать в адресе, формой или JSON. Это сделано ради совместимости с трекерами, которые умеют только подставлять макросы в ссылку.

Нюансы

  • Не каждый «REST» на практике соответствует принципам полностью. В документации смотрите конкретные адреса и параметры, а не само слово.
  • Отсутствие состояния означает, что ключи нужно передавать в каждом запросе.
  • Код ответа важен не меньше тела: по нему решают, повторять запрос или нет.

Практический совет

Если вы выбираете между разными сетями, сравнивайте не слова «у нас REST», а полноту документации: есть ли примеры запросов, перечень кодов ошибок, описание повторов и ограничений. Это сильнее влияет на скорость подключения, чем стиль интерфейса.

Связанные понятия

REST опирается на HTTP-запросы GET и POST, формат обмена — чаще всего JSON. Всё вместе образует API. Описание наших адресов собрано в разделе API.

Вопросы и ответы

REST и API — одно и то же?

Нет. API — общее понятие интерфейса, REST — один из стилей его построения. Бывают и другие, например SOAP.

Нужен ли REST, чтобы подключиться к сети?

Нет. Достаточно уметь отправить запрос на нужный адрес с параметрами.