API Reference

Публичный HTTP API для приёма заявок.

POST /api/c1/sites/{siteKey}/submissions

Отправить заявку. Публичный endpoint — не требует авторизации.

Параметры пути

Заголовки

Тело запроса

{
  "data": {
    "name": "Иван Петров",
    "email": "ivan@example.com",
    "phone": "+7 900 000-00-00",
    "message": "Произвольный текст"
  },
  "captcha_challenge_id": "01HXYZ...",
  "captcha_answer": 42
}

Поле data — произвольный JSON-объект. Ключи — имена полей формы. Поля captcha_challenge_id и captcha_answer нужны только если капча включена на сайте.

Ответ — 200 OK

{ "id": "01HXYZ..." }

Пример curl

curl -X POST https://app.form-hook.com/api/c1/sites/ВАШ_SITE_KEY/submissions \
  -H "Content-Type: application/json" \
  -H "Origin: https://example.com" \
  -d '{
    "data": {
      "name": "Иван Петров",
      "email": "ivan@example.com"
    }
  }'

POST /api/c1/sites/{siteKey}/captcha/challenges

Получить captcha challenge — только при прямом HTTP без SDK.

Тело запроса

Пустое (или {}).

Ответ — 200 OK

{
  "challenge_id": "01HXYZ...",
  "question": "3 + 7 = ?",
  "expires_at": "2026-05-05T12:05:00Z"
}

Передайте challenge_id и ответ на вопрос в поле captcha_answer при отправке заявки.

Коды ошибок HTTP API

Формат ответа с ошибкой

{
  "code": "VALIDATION_ERROR",
  "message": "Validation failed",
  "fields": [
    { "name": "email", "message": "Обязательное поле" }
  ]
}

Коды ошибок SDK

Метод formhook.submit() бросает с объектом { code, message } при ошибке:

CORS

Endpoint принимает запросы только с доменов из списка разрешённых в настройках сайта. Для прямых server-side запросов (curl, backend) заголовок Origin можно не указывать — CORS проверяется только для браузерных запросов.

Лимиты