Публичное API

Где использовать

Базовый URL

https://funnelica.ru/api/v1

Аутентификация

Большинство эндпоинтов работают без авторизации. Исключение — студенческий портал: там требуется Bearer-токен, который студент получает после входа по коду из email.

Формат

Все запросы и ответы в формате JSON. Для POST/PUT запросов указывайте заголовок Content-Type: application/json.

Заголовки

Отправка данных формы. Создаёт или обновляет контакт в CRM и сохраняет заявку.

Параметры

Тело запроса

Пример

POST https://funnelica.ru/api/v1/forms/form_abc123/submit
Content-Type: application/json

{
  "email": "ivan@example.com",
  "name": "Иван",
  "phone": "+7 999 123-45-67",
  "payload": {
    "message": "Вопрос по тарифам"
  },
  "utm": {
    "utm_source": "yandex"
  }
}

Ответ 200

{
  "submissionId": "sub_abc123",
  "contactId": "contact_xyz789",
  "status": "received"
}

Получение опубликованных страниц и отслеживание просмотров.

Получить страницу по пути.

GET https://funnelica.ru/api/v1/public/pages/by-path?path=/landing

Ответ

{
  "id": "page_abc",
  "name": "Лендинг",
  "path": "/landing",
  "status": "published",
  "schema": {
    "editor": "grapesjs",
    "html": "...",
    "css": "..."
  },
  "experiment": {
    "experimentId": "exp_123",
    "variant": "A"
  }
}

Получить страницу по ID.

Отправить событие просмотра страницы.

Получить публичные данные формы для встраивания.

Получение структуры воронки и отслеживание прохождения шагов.

Получить воронку со списком шагов.

{
  "id": "funnel_abc",
  "name": "Воронка запуска",
  "status": "active",
  "steps": [
    { "id": "step_1", "type": "page", "name": "Лендинг" },
    { "id": "step_2", "type": "checkout", "name": "Оплата" }
  ]
}

Отметить посещение шага.

Получить следующий шаг с учётом условий.

Выполнить шаг (трекинг + переход).

Создание заказов и обработка оплаты.

Получить настройки checkout.

Проверить промокод.

{
  "checkoutPath": "/checkout/course",
  "couponCode": "SALE20"
}

Ответ

{
  "valid": true,
  "discount": 2000,
  "finalAmount": 8000,
  "originalAmount": 10000,
  "currency": "RUB"
}

Создать заказ и получить ссылку на оплату.

POST https://funnelica.ru/api/v1/public/checkout/create-order

{
  "checkoutPath": "/checkout/course",
  "email": "ivan@example.com",
  "name": "Иван",
  "couponCode": "SALE20"
}

Ответ

{
  "orderId": "order_abc123",
  "status": "pending",
  "amount": 8000,
  "currency": "RUB",
  "paymentUrl": "https://yookassa.ru/checkout/..."
}

Получить URL редиректа после оплаты.

Обработать ответ на upsell/downsell.

Публичные эндпоинты для просмотра и валидации сертификатов.

Скачать сертификат в PDF.

Проверить подлинность сертификата.

Трекинг открытий и кликов в email-рассылках.

Пиксель открытия (возвращает GIF 1x1).

Трекинг клика с редиректом.

Страница отписки (HTML).

One-click отписка (List-Unsubscribe-Post).

Авторизация студентов по email с кодом и доступ к курсам.

Авторизация

Запросить код для входа. Отправляет код на email.

POST https://funnelica.ru/api/v1/student/auth/request-login

{ "email": "student@example.com" }

Подтвердить код и получить токены.

{
  "accessToken": "eyJhbGciOiJIUzI1...",
  "refreshToken": "refresh_abc...",
  "contact": {
    "id": "contact_xyz",
    "email": "student@example.com",
    "name": "Иван"
  }
}

Обновить токен.

Защищённые эндпоинты

Требуют заголовок Authorization: Bearer <accessToken>

Профиль студента.

Дашборд с общим прогрессом.

Список доступных курсов.

Список сертификатов студента.

Детали курса по записи.

Контент урока.

Обновить прогресс урока.

Отправить домашнее задание.

Задать вопрос по уроку.

Отправить ответы на тест.

Формат ошибки и HTTP-коды ответов.

{
  "statusCode": 400,
  "message": "Validation failed",
  "error": "Bad Request"
}

HTTP-коды