🔌API и интеграции

Формы и ответы через API

Обновлено сегодня•Время чтения: 3 мин

В этом разделе — минимальный способ работать с данными: получить список форм, выбрать нужную форму и забирать ответы по ней.

Схема «Получить формы → выбрать форму → забрать ответы»

Формы (метаданные)

Эти ручки возвращают метаданные формы (например, id и название).

  • GET `/v1/forms` — список форм
  • GET `/v1/forms/:id` — форма по id

Типовой сценарий: Список форм → выбрали нужную → используете ее id для ответов и статистики.

Ответы по форме

Чтобы забрать ответы:

  • GET `/v1/forms/:id/responses` — список ответов
  • GET `/v1/forms/:id/responses/:responseId` — один конкретный ответ

Сценарии: Список ответов → открыли конкретный ответ → сохранили в CRM/таблицу/БД.

Раздел «Ответы» в личном кабинете (аналогия с API)

Экспорт в CSV

Если вам удобнее работать таблично или грузить в другие системы через CSV:

  • GET `/v1/forms/:id/responses/export?format=csv`

Это полезно, когда: → нужен быстрый перенос данных в таблицы → делаете разовый отчет → импортируете данные в сторонний инструмент без прямой интеграции

Дальше по теме

Далее логично разобрать, как получать статистику по форме и сводную статистику, чтобы строить отчеты по эффективности и конверсии без ручного подсчета.