Langsung ke konten

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 ​

PaketPesan per hari
Gratis50
Starter1.000
Medium5.000
LargeTanpa 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 rejected agar 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
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
json
{
  "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:

bash
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:

HeaderArti
X-PA-Daily-LimitPesan yang diizinkan per hari sesuai paket Anda
X-PA-Daily-RemainingSisa pesan hari ini, setelah pesan ini
X-PA-Daily-ResetTimestamp 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 ​

Dokumentasi Pocket Alert