Langsung ke konten

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}/submit

Autentikasi ​

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 ​

ParameterTipeWajibDeskripsi
tidstring✅Pengenal formulir

Parameter Body ​

ParameterTipeWajibDeskripsi
valuesobject✅Jawaban yang dikelompokkan berdasarkan id kolom
websitestring❌Honeypot. Biarkan kosong; nilai apa pun yang tidak kosong akan dianggap bot

Nilai untuk setiap tipe kolom:

TipeNilai
text, textarea, email, phone, number, urlString. Format divalidasi untuk email, phone, number, dan URL
dateString, YYYY-MM-DD
dropdown, radioString, salah satu dari options kolom
checkboxesArray string dari options
checkboxBoolean
ratingNumber, 1–5
npsNumber, 0–10
hiddenString, 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 ​

bash
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"
    }
  }'
javascript
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);
}
python
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

json
{ "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.

json
{
  "error": "Please check the highlighted fields.",
  "fields": {
    "email": "Enter a valid email address",
    "name": "This field is required"
  }
}

Formulir Ditutup ​

410 Gone

json
{
  "error": "This form is no longer accepting responses.",
  "closed": true
}

error berisi closed_message milik pemilik itu sendiri.

Batasan ​

BatasanNilai
Per IP10 pengiriman per menit
Per formulir60 per menit, 300 per jam
Kuota pemilikSetiap 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 ​

StatusDeskripsi
400Body tidak valid, atau fields mencantumkan jawaban yang perlu diperbaiki
403Formulir tidak menerima pengiriman dari situs ini — lihat asal yang diizinkan
404Formulir tidak ditemukan
410Formulir sudah ditutup
429Terlalu banyak pengiriman, atau pemilik telah kehabisan pesan untuk hari ini
500Formulir salah dikonfigurasi, atau pesan tidak dapat dibuat

Dokumentasi Pocket Alert