Langsung ke konten

Penggunaan Pesan GET ​

Dapatkan penggunaan pesan hari ini terhadap batas harian paket Anda.

Endpoint ​

GET https://api.pocketalert.app/v1/messages/usage

Autentikasi ​

Wajib

Sertakan salah satu header berikut dalam permintaan Anda:

  • Token: <your-api-key> — Dapatkan dari Kunci API
  • Authorization: Bearer <jwt-token> — Dari Masuk

Permintaan ​

Contoh Permintaan ​

bash
curl -X GET "https://api.pocketalert.app/v1/messages/usage" \
  -H "Token: your-api-key"
javascript
const response = await fetch('https://api.pocketalert.app/v1/messages/usage', {
  headers: { 'Token': 'your-api-key' }
});
const usage = await response.json();
python
import requests

response = requests.get(
    'https://api.pocketalert.app/v1/messages/usage',
    headers={'Token': 'your-api-key'}
)
print(response.json())
php
$response = Http::withHeaders([
    'Token' => 'your-api-key',
])->get('https://api.pocketalert.app/v1/messages/usage');

return $response->json();

Respons ​

Respons Sukses ​

200 OK

Mengembalikan penggunaan hari ini. Hari yang dimaksud adalah hari UTC.

FieldTipeDeskripsi
usedintegerPesan yang diterima hari ini
limitinteger | nullPesan yang diizinkan per hari, null pada paket tanpa batas
unlimitedbooleantrue jika paket tidak memiliki batas harian
rejectedintegerPermintaan yang ditolak hari ini karena batas sudah tercapai
resets_atstringReset berikutnya, 00:00 UTC, dalam RFC3339
json
{
  "used": 42,
  "limit": 50,
  "unlimited": false,
  "rejected": 0,
  "resets_at": "2026-09-22T00:00:00Z"
}

Pada paket tanpa batas:

json
{
  "used": 1280,
  "limit": null,
  "unlimited": true,
  "rejected": 0,
  "resets_at": "2026-09-22T00:00:00Z"
}

Respons Error ​

StatusDeskripsi
401Tidak diizinkan — Token tidak valid atau tidak ada

Kasus Penggunaan

Periksa used terhadap limit sebelum mengirim banyak peringatan sekaligus, atau tampilkan sisa kuota di dasbor Anda sendiri. Angka yang sama juga dikembalikan pada setiap respons Buat Pesan sebagai header X-PA-Daily-*.

Dokumentasi Pocket Alert