# 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](https://pocketalert.app/account/billing), dan juga dapat diakses melalui API di [`GET /v1/messages/usage`](https://info.pocketalert.app/api/messages/usage.md).

## 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`](https://info.pocketalert.app/api/messages/create.md), 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.

> **Warning: 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"
}
```

> **Tip: 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.

> **Warning: `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](https://info.pocketalert.app/api/webhooks/history.md) 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](https://pocketalert.app/pricing).

## Terkait

- [Buat Pesan](https://info.pocketalert.app/api/messages/create.md) — respons `429` dalam konteks
- [Penggunaan pesan](https://info.pocketalert.app/api/messages/usage.md) — penggunaan hari ini melalui API
- [Riwayat webhook](https://info.pocketalert.app/api/webhooks/history.md) — tempat panggilan webhook yang ditolak disimpan
- [Pengiriman terjadwal](https://info.pocketalert.app/features/scheduled-delivery.md) — cara pesan terjadwal dihitung
