Enviar formulário POST
Envie uma resposta. A submissão vira uma mensagem na conta do dono e é enviada como notificação push para o celular dele — o mesmo fluxo que uma chamada de webhook percorre. Sem autenticação.
Endpoint
POST https://api.pocketalert.app/v1/forms/{tid}/submitAutenticação
Não é necessária
Qualquer pessoa que tenha o link pode enviar. O dono controla quem pode: veja origens permitidas e os limites abaixo.
Requisição
Parâmetros de caminho
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tid | string | ✅ | Identificador do formulário |
Parâmetros do corpo
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
values | object | ✅ | Respostas indexadas pelo id do campo |
website | string | ❌ | Honeypot. Deixe de fora; qualquer valor não vazio é tratado como bot |
Valor por tipo de campo:
| Tipo | Valor |
|---|---|
text, textarea, email, phone, number, url | String. O formato é validado para email, phone, number e URL |
date | String, YYYY-MM-DD |
dropdown, radio | String, uma das options do campo |
checkboxes | Array de strings de options |
checkbox | Boolean |
rating | Número, 1–5 |
nps | Número, 0–10 |
hidden | String, normalmente obtida da URL da página |
Campos de layout (heading, paragraph, divider) não recebem valor, e chaves desconhecidas são ignoradas. O corpo tem limite de 64 KB.
Exemplo de requisição
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())Resposta
Resposta de sucesso
200 OK
{ "status": "ok" }O dono recebe uma notificação push montada com as respostas. Nada sobre o dono — o plano dele, seus dispositivos, sua cota — é exposto ao visitante.
Erros de validação
400 Bad Request
fields mapeia o id de um campo para o motivo da rejeição, que é o que a página do formulário exibe abaixo de cada campo.
{
"error": "Please check the highlighted fields.",
"fields": {
"email": "Enter a valid email address",
"name": "This field is required"
}
}Formulário fechado
410 Gone
{
"error": "This form is no longer accepting responses.",
"closed": true
}error traz o closed_message próprio do dono.
Limites
| Limite | Valor |
|---|---|
| Por IP | 10 envios por minuto |
| Por formulário | 60 por minuto, 300 por hora |
| Cota do dono | Cada envio usa uma mensagem da cota diária dele |
Um envio que ultrapassaria o limite diário de mensagens do dono recebe um 429 neutro, com o cabeçalho Retry-After e sem menção ao plano.
Respostas de erro
| Status | Descrição |
|---|---|
400 | Corpo inválido, ou fields lista as respostas que precisam ser corrigidas |
403 | O formulário não aceita envios deste site — veja origens permitidas |
404 | Formulário não encontrado |
410 | O formulário está fechado |
429 | Muitos envios, ou o dono esgotou as mensagens de hoje |
500 | O formulário está mal configurado, ou a mensagem não pôde ser criada |