Batas Pesan Harian
Setiap paket memiliki jumlah pesan per hari. Hitungannya direset pada 00:00 UTC. Setelah Anda mencapai batas, pesan baru akan ditolak dengan 429 Too Many Requests hingga reset — pesan tersebut tidak disimpan dan tidak ada push notification yang dikirim.
Batas berdasarkan paket
| Paket | Pesan per hari |
|---|---|
| Gratis | 50 |
| Starter | 1.000 |
| Medium | 5.000 |
| Large | Tanpa batas |
Paket Anda saat ini dan penggunaan hari ini tersedia di halaman Tagihan, dan juga dapat diakses melalui API di GET /v1/messages/usage.
Apa saja yang dihitung
Setiap pesan yang dibuat di akun Anda dihitung sekali, pada hari UTC saat pesan itu dibuat:
- Permintaan API —
POST /v1/messages, termasuk permintaan dengan lampiran. - Panggilan webhook — setiap panggilan yang menghasilkan pesan.
- Pesan terjadwal — dihitung pada hari Anda menjadwalkannya, bukan pada hari pesan dikirim. Pesan yang dijadwalkan hari ini untuk Selasa depan menggunakan kuota hari ini; pengiriman itu sendiri tidak pernah memakan kuota dan tidak pernah diblokir karenanya.
Yang tidak dihitung:
- Permintaan yang gagal validasi (
400,403) atau gagal di sisi kami (500) — kuotanya dikembalikan. - Permintaan yang ditolak itu sendiri. Permintaan tersebut dicatat terpisah sebagai
rejectedagar Anda dapat melihat notifikasi apa saja yang terlewat.
Menghapus pesan tidak mengembalikan kuota
Penghitung melacak pesan yang terkirim, bukan pesan yang tersimpan. Menghapus pesan — satu per satu maupun sekaligus — tidak mengembalikan kuota hari ini.
Saat batas tercapai
API akan merespons dengan 429 Too Many Requests beserta header Retry-After yang berisi jumlah detik hingga reset:
HTTP/1.1 429 Too Many Requests
Retry-After: 30142
X-PA-Daily-Limit: 50
X-PA-Daily-Remaining: 0
X-PA-Daily-Reset: 1790035200{
"error": "Daily message limit reached (50/50). New messages are rejected until 00:00 UTC. Upgrade your plan to raise the limit.",
"limit": 50,
"used": 50,
"resets_at": "2026-09-22T00:00:00Z",
"upgrade_url": "https://pocketalert.app/pricing"
}Menangani 429 di integrasi Anda
Perlakukan 429 sebagai "belum sekarang", bukan sebagai kegagalan sementara. Mencoba ulang sebelum Retry-After berlalu akan mendapat jawaban yang sama — setiap percobaan ulang ditolak dan tetap dihitung. Anda bisa menunggu hingga resets_at, atau membuang notifikasi tersebut dan mencatatnya di log.
curl --retry bisa menggantung sampai tengah malam
curl --retry menganggap 429 dapat dicoba ulang dan menghormati Retry-After, sehingga skrip yang mencoba ulang melewati batas akan tertidur hingga 00:00 UTC. Batasi waktu tunggunya dengan --retry-max-time:
curl --retry 3 --retry-max-time 60 -X POST "https://api.pocketalert.app/v1/messages" ...Webhook
Panggilan webhook di atas batas ditolak dengan 429 yang sama, tetapi setiap panggilan tetap dicatat di riwayat webhook beserta payload lengkapnya dan pesan yang seharusnya dihasilkan. Entri tersebut memiliki status: "error" dan error_code: "daily_limit", sehingga tidak ada yang hilang tanpa jejak — buka riwayat untuk melihat apa yang masuk selama Anda melewati batas.
Header batas laju
Setiap POST /v1/messages yang berhasil (dan setiap panggilan webhook yang membuat pesan) membawa informasi kuota saat ini:
| Header | Arti |
|---|---|
X-PA-Daily-Limit | Pesan yang diizinkan per hari sesuai paket Anda |
X-PA-Daily-Remaining | Sisa pesan hari ini, setelah pesan ini |
X-PA-Daily-Reset | Timestamp Unix (detik) untuk reset berikutnya, 00:00 UTC |
Paket tanpa batas tidak menerima header ini.
Email
Pocket Alert mengirim email kepada pemilik akun paling banyak dua kali per hari:
- Pada 80% dari batas harian — pemberitahuan dini selagi masih ada sisa kuota.
- Pada pesan pertama yang ditolak — batas sudah tercapai dan pesan baru mulai ditolak.
Paket tanpa batas tidak pernah menerima email ini.
Meningkatkan paket
Paket baru langsung berlaku: setelah peningkatan selesai, permintaan berikutnya akan diperiksa terhadap batas yang baru — tanpa perlu menunggu reset. Lihat harga.
Terkait
- Buat Pesan — respons
429dalam konteks - Penggunaan pesan — penggunaan hari ini melalui API
- Riwayat webhook — tempat panggilan webhook yang ditolak disimpan
- Pengiriman terjadwal — cara pesan terjadwal dihitung