Formular absenden POST
Sende eine Antwort. Die Einsendung wird zu einer Nachricht im Konto des Besitzers und als Push-Benachrichtigung auf dessen Handy zugestellt — denselben Weg, den ein Webhook-Aufruf nimmt. Keine Authentifizierung.
Endpunkt
POST https://api.pocketalert.app/v1/forms/{tid}/submitAuthentifizierung
Nicht erforderlich
Jeder, der den Link hat, kann absenden. Der Besitzer legt fest, wer das darf: siehe erlaubte Ursprünge und die Limits unten.
Anfrage
Pfadparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
tid | string | ✅ | Formular-Kennung |
Body-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
values | object | ✅ | Antworten, geordnet nach Feld-id |
website | string | ❌ | Honeypot. Weglassen; alles Nicht-Leere wird als Bot behandelt |
Wert pro Feldtyp:
| Typ | Wert |
|---|---|
text, textarea, email, phone, number, url | String. Format wird bei E-Mail, Telefon, Zahl und URL geprüft |
date | String, YYYY-MM-DD |
dropdown, radio | String, einer der options des Feldes |
checkboxes | Array aus Strings aus options |
checkbox | Boolean |
rating | Zahl, 1–5 |
nps | Zahl, 0–10 |
hidden | String, üblicherweise aus der Seiten-URL übernommen |
Layout-Felder (heading, paragraph, divider) nehmen keinen Wert entgegen, unbekannte Schlüssel werden ignoriert. Der Body ist auf 64 KB begrenzt.
Beispielanfrage
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())Antwort
Erfolgreiche Antwort
200 OK
{ "status": "ok" }Der Besitzer erhält eine Push-Benachrichtigung, die aus den Antworten gebaut wird. Informationen über den Besitzer — sein Tarif, seine Geräte, sein Kontingent — werden dem Besucher nicht offengelegt.
Validierungsfehler
400 Bad Request
fields ordnet einer Feld-id den Grund zu, warum sie abgelehnt wurde. Das zeigt die Formularseite unter jedem Eingabefeld an.
{
"error": "Please check the highlighted fields.",
"fields": {
"email": "Enter a valid email address",
"name": "This field is required"
}
}Geschlossenes Formular
410 Gone
{
"error": "This form is no longer accepting responses.",
"closed": true
}error enthält das eigene closed_message des Besitzers.
Limits
| Limit | Wert |
|---|---|
| Pro IP | 10 Einsendungen pro Minute |
| Pro Formular | 60 pro Minute, 300 pro Stunde |
| Kontingent des Besitzers | Jede Einsendung verbraucht eine Nachricht aus seinem Tageskontingent |
Eine Einsendung, die das Tageslimit an Nachrichten des Besitzers überschreiten würde, erhält ein neutrales 429 mit einem Retry-After-Header und ohne Hinweis auf den Tarif.
Fehlerantworten
| Status | Beschreibung |
|---|---|
400 | Ungültiger Body, oder fields listet die zu korrigierenden Antworten auf |
403 | Das Formular akzeptiert keine Einsendungen von dieser Website — siehe erlaubte Ursprünge |
404 | Formular nicht gefunden |
410 | Das Formular ist geschlossen |
429 | Zu viele Einsendungen, oder der Besitzer hat heute keine Nachrichten mehr |
500 | Das Formular ist falsch konfiguriert, oder die Nachricht konnte nicht erstellt werden |