Что это
Typeform API связывает формы Typeform с вашим процессом: выгрузкой ответов, регистрацией на мероприятие или сбором обратной связи. Responses API читает результаты, а webhook сообщает о новой отправке. Create API нужен для программной работы с самими формами.
Ответы имеют разные типы: текст, число, вариант выбора или логическое значение. Сопоставляйте их с полями по ID или ref, а не по порядку в массиве. Иначе после изменения анкеты вопрос о согласии может оказаться перепутан с другим ответом.
Обычное чтение API не означает мгновенное появление новой заявки: документация предупреждает о задержке свежих ответов. Для событий используйте защищенный webhook. AI-возможности других продуктов Typeform не следует считать функцией простого GET responses.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Ответы приходят в JSON с ID полей и типами значений.
- Можно выбирать период и нужные поля выгрузки.
- Webhooks передают новые отправки в приложение.
- Scopes позволяют ограничить разрешенные действия токена.
Ограничения
- Число ответов и возможности зависят от плана.
- Свежие ответы могут появиться в Responses API с задержкой.
- Нужно обрабатывать разные типы, пропуски и изменения формы.
- Webhook требует проверки подписи и защиты от повторов.
Как использовать
1. Подготовка. Создайте отдельную учебную форму с текстовым вопросом и выбором варианта. Отправьте два ответа без личных контактов и запишите ID формы из ее URL. Не используйте действующую клиентскую анкету.
2. Настройка. В Account → Personal tokens создайте токен с нужными минимальными scopes; для чтения ответов нужен responses:read. Храните его на сервере, запросы выполняйте с Authorization: Bearer TOKEN. Для подключения чужих аккаунтов используйте OAuth.
3. Первый результат. Выполните GET https://api.typeform.com/forms/{form_id}/responses?page_size=2&response_type=completed. Из items получите response_id, submitted_at и answers. Сопоставьте каждый answer.field.id или ref с вопросом, а значение прочитайте по answer.type.
4. Проверка. Сверьте оба ответа в интерфейсе. Если они еще не появились, учтите задержку API, не создавайте дубликаты. Для полной выгрузки используйте документированные before/after или временные фильтры. Для событий настройте HTTPS webhook, Typeform-Signature по исходному телу и исключение повторных ответов; отправку писем пока не включайте.
Примеры сценариев
- Получить два обезличенных ответа анкеты.
- Сверить выбор участника с исходным вопросом.
- Подготовить черновик сводки обратной связи.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Есть бесплатный план с ограниченным числом ответов и платные планы с дополнительными возможностями. Проверьте доступные лимиты своей формы; стоимость внешней модели и автоматизации не включена автоматически. Российская оплата и доступ здесь не проверены.
Когда не подходит
- Считать контакт разрешением на рассылку
- Привязывать ответы только к номеру в массиве
- Ожидать мгновенного результата от периодического GET
Альтернативы
SurveyMonkey API работает с опросами SurveyMonkey. n8n организует обработку формы, но сам не заменяет все возможности Typeform. Google Sheets API удобен для хранения простой таблицы заявок, а не как полный конструктор анкет.
