Submit Form POST
Kirim respons. Pengiriman ini menjadi pesan di akun pemilik dan diteruskan sebagai push notification ke ponselnya — melalui jalur yang sama dengan panggilan webhook. Tanpa autentikasi.
Endpoint
POST https://api.pocketalert.app/v1/forms/{tid}/submitAutentikasi
Tidak diperlukan
Siapa pun yang memiliki tautan dapat mengirim. Pemilik mengontrol siapa yang boleh: lihat asal yang diizinkan dan batasan di bawah.
Permintaan
Parameter Path
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
tid | string | ✅ | Pengenal formulir |
Parameter Body
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
values | object | ✅ | Jawaban yang dikelompokkan berdasarkan id kolom |
website | string | ❌ | Honeypot. Biarkan kosong; nilai apa pun yang tidak kosong akan dianggap bot |
Nilai untuk setiap tipe kolom:
| Tipe | Nilai |
|---|---|
text, textarea, email, phone, number, url | String. Format divalidasi untuk email, phone, number, dan URL |
date | String, YYYY-MM-DD |
dropdown, radio | String, salah satu dari options kolom |
checkboxes | Array string dari options |
checkbox | Boolean |
rating | Number, 1–5 |
nps | Number, 0–10 |
hidden | String, biasanya diambil dari URL halaman |
Kolom tata letak (heading, paragraph, divider) tidak menerima nilai, dan kunci yang tidak dikenal akan diabaikan. Body dibatasi maksimal 64 KB.
Contoh Permintaan
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())Respons
Respons Sukses
200 OK
{ "status": "ok" }Pemilik menerima push notification yang dibuat dari jawaban tersebut. Tidak ada informasi tentang pemilik — paket, perangkat, atau kuotanya — yang ditampilkan kepada pengunjung.
Kesalahan Validasi
400 Bad Request
fields memetakan id kolom ke alasan penolakannya, yang ditampilkan halaman formulir di bawah setiap input.
{
"error": "Please check the highlighted fields.",
"fields": {
"email": "Enter a valid email address",
"name": "This field is required"
}
}Formulir Ditutup
410 Gone
{
"error": "This form is no longer accepting responses.",
"closed": true
}error berisi closed_message milik pemilik itu sendiri.
Batasan
| Batasan | Nilai |
|---|---|
| Per IP | 10 pengiriman per menit |
| Per formulir | 60 per menit, 300 per jam |
| Kuota pemilik | Setiap pengiriman menggunakan satu pesan dari batas harian pemilik |
Pengiriman yang akan melampaui batas harian pesan pemilik akan menerima 429 netral dengan header Retry-After dan tanpa penyebutan paket.
Respons Kesalahan
| Status | Deskripsi |
|---|---|
400 | Body tidak valid, atau fields mencantumkan jawaban yang perlu diperbaiki |
403 | Formulir tidak menerima pengiriman dari situs ini — lihat asal yang diizinkan |
404 | Formulir tidak ditemukan |
410 | Formulir sudah ditutup |
429 | Terlalu banyak pengiriman, atau pemilik telah kehabisan pesan untuk hari ini |
500 | Formulir salah dikonfigurasi, atau pesan tidak dapat dibuat |