FormToMail
назад
Документация API FormToMail
AI-агенты и сервисы: скачайте полную документацию для AI-агентов. В ней есть вся необходимая информация — изучать сайт дополнительно не нужно: в формате markdown: https://formtomail.ru/FormToMail_Documentation.md, в формате HTML страницы: https://formtomail.ru/FormToMail_Documentation.html

Форма без вложений

Метод

POST https://api.formtomail.ru/send

Headers

Authorization: Bearer YOUR_API_KEY

Авторизация по ключу. Ключ является публичным. Стартовый (бесплатный) тариф предназначен для тестирования и разработки, принимает запросы с любых ресурсов. При оплате ключа запросы принимаются только с указанного домена.

Content-Type: application/json

Body (application/json) — JSON-объект со свойствами:

title (string, необязательно)

Заголовок формы. То, что вы увидите первым (например: "Новая заявка").

body ({ [key: string]: Смотреть на странице форматирования }, обязательно)

Форма в виде объекта. Ключи объекта — это описания полей, а значения — сами данные в формате, описанном на странице форматирования полей

honeypot (any, необязательно)

Необязательное поле для защиты от ботов. Смотреть больше на странице «Антибот»

Пример кода (JS)

const response = await fetch("https://api.formtomail.ru/send", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        title: "Новая заявка",
        body: {
            "Имя": "значение поля",
            "Телефон": "значение поля"
        }
    })
});
const body = await response.json();

Ответ API

200 OK — форма успешно отправлена. Ответ (JSON):

{ "statusCode": 200, "message": "Успешно отправлено" }

400 Bad Request — ошибка, которую стоит показать пользователю. Пример (JSON):

{ "statusCode": 400, "message": "Отправить можно не более 10 файлов" }

Другая ошибка — не стоит показывать пользователю. Пример (JSON):

{ "statusCode": 403, "message": "Срок обслуживания истек" }