Отправка формы POST
Отправляет ответ. Отправка становится сообщением в аккаунте владельца и доставляется на его телефон push-уведомлением — тем же путём, что и вызов вебхука. Аутентификация не нужна.
Эндпоинт
POST https://api.pocketalert.app/v1/forms/{tid}/submitАутентификация
Не требуется
Отправить может любой, у кого есть ссылка. Владелец сам задаёт, кто может отправлять: см. разрешённые источники и лимиты ниже.
Запрос
Параметры пути
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
tid | string | ✅ | Идентификатор формы |
Параметры тела запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
values | object | ✅ | Ответы, где ключ — id поля |
website | string | ❌ | Honeypot. Не передавайте его; любое непустое значение считается ботом |
Значение для каждого типа поля:
| Тип | Значение |
|---|---|
text, textarea, email, phone, number, url | Строка. Формат проверяется для email, телефона, числа и URL |
date | Строка, YYYY-MM-DD |
dropdown, radio | Строка, одно из значений options поля |
checkboxes | Массив строк из options |
checkbox | Boolean |
rating | Число, 1–5 |
nps | Число, 0–10 |
hidden | Строка, обычно берётся из URL страницы |
Поля оформления (heading, paragraph, divider) значения не принимают, а неизвестные ключи игнорируются. Размер тела запроса ограничен 64 КБ.
Пример запроса
curl -X POST "https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9/submit" \
-H "Content-Type: application/json" \
-d '{
"values": {
"name": "Jane Doe",
"email": "[email protected]",
"message": "Do you ship to Canada?",
"src": "newsletter"
}
}'const response = await fetch(
'https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9/submit',
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
values: {
name: 'Jane Doe',
email: '[email protected]',
message: 'Do you ship to Canada?'
}
})
}
);
const result = await response.json();
if (response.status === 400) {
// result.fields = { email: "Enter a valid email address" }
console.log(result.fields);
}import requests
response = requests.post(
'https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9/submit',
json={
'values': {
'name': 'Jane Doe',
'email': '[email protected]',
'message': 'Do you ship to Canada?',
}
}
)
print(response.status_code, response.json())Ответ
Успешный ответ
200 OK
{ "status": "ok" }Владелец получает push-уведомление, составленное из ответов. Информация о владельце — его тариф, устройства, квоты — посетителю не раскрывается.
Ошибки валидации
400 Bad Request
fields сопоставляет id поля с причиной отклонения; именно это страница формы выводит под каждым полем.
{
"error": "Please check the highlighted fields.",
"fields": {
"email": "Enter a valid email address",
"name": "This field is required"
}
}Закрытая форма
410 Gone
{
"error": "This form is no longer accepting responses.",
"closed": true
}В error передаётся собственное сообщение владельца closed_message.
Лимиты
| Лимит | Значение |
|---|---|
| С одного IP | 10 отправок в минуту |
| На форму | 60 в минуту, 300 в час |
| Квота владельца | Каждая отправка расходует одно сообщение из его дневного лимита |
Отправка, которая превысила бы дневной лимит сообщений владельца, получает нейтральный ответ 429 с заголовком Retry-After без упоминания тарифа.
Ответы с ошибками
| Статус | Описание |
|---|---|
400 | Некорректное тело запроса или fields перечисляет ответы, которые нужно исправить |
403 | Форма не принимает отправки с этого сайта — см. разрешённые источники |
404 | Форма не найдена |
410 | Форма закрыта |
429 | Слишком много отправок или у владельца закончились сообщения на сегодня |
500 | Форма настроена неправильно или не удалось создать сообщение |