Langsung ke konten

Scheduled Delivery ​

Kirim pesan sekarang, tiba nanti. Tambahkan send_at atau delay ke permintaan Create Message mana pun dan Pocket Alert menyimpannya secara terenkripsi hingga waktu pengiriman, lalu mengirimkannya sebagai push notification biasa.

Tidak perlu cron job di sisi Anda, tidak perlu queue worker, tidak perlu proses yang harus terus berjalan sampai hari Selasa.

Dua cara menentukan waktu ​

ParameterMenerimaContoh
send_atRFC3339, Unix timestamp, atau YYYY-MM-DD HH:MM2026-08-15T09:00:00Z, 1786867200, 2026-08-15 09:00
delayDurasi gaya Go atau detik saja30m, 2h, 90s, 3600

Kirim salah satu saja — mengirim keduanya akan mengembalikan 400.

send_at tanpa offset zona waktu dibaca dalam zona waktu akun Anda, sehingga 2026-08-15 09:00 berarti pukul sembilan pagi di tempat Anda berada, bukan UTC. Atur di pengaturan akun.

Menjadwalkan pesan ​

bash
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Certificate expires tomorrow",
    "message": "api.example.com — renew before 09:00 UTC",
    "send_at": "2026-08-15T09:00:00Z",
    "level": "high"
  }'
bash
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Check the migration",
    "message": "Started at 14:02 — verify row counts",
    "delay": "2h"
  }'
javascript
await fetch('https://api.pocketalert.app/v1/messages', {
  method: 'POST',
  headers: { 'Token': 'your-api-key', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    title: 'Check the migration',
    message: 'Started at 14:02 — verify row counts',
    delay: '2h'
  })
});
python
import requests

requests.post(
    'https://api.pocketalert.app/v1/messages',
    headers={'Token': 'your-api-key'},
    json={
        'title': 'Check the migration',
        'message': 'Started at 14:02 — verify row counts',
        'delay': '2h'
    }
)

Pesan yang dijadwalkan mengembalikan 201 dengan "scheduled": true, bukan pesan yang sudah terkirim:

json
{
  "tid": "n8k2vq7pxr4m",
  "scheduled": true,
  "status": "pending",
  "title": "Check the migration",
  "deliver_at": "09.08.2026 16:02:00",
  "deliver_at_utc": "2026-08-09T13:02:00Z",
  "tz": "Europe/Berlin"
}

Simpan tid — itulah yang digunakan untuk membatalkan.

Melihat daftar pesan terjadwal GET ​

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

Secara default mengembalikan pesan yang masih menunggu, diurutkan dari yang paling dekat.

Query parameterNilaiDeskripsi
statuspending, sending, sent, canceled, failed, allFilter berdasarkan status. Defaultnya pending.
bash
curl -X GET "https://api.pocketalert.app/v1/messages/scheduled?status=all" \
  -H "Token: your-api-key"

Setiap item memuat tid, title, message, priority, status, deliver_at, deliver_at_utc, tz, application, device, created_at, dan actions jika pesan memiliki tombol.

Membatalkan DELETE ​

DELETE https://api.pocketalert.app/v1/messages/scheduled/{tid}
bash
curl -X DELETE "https://api.pocketalert.app/v1/messages/scheduled/n8k2vq7pxr4m" \
  -H "Token: your-api-key"
StatusArti
200Dibatalkan. Lampiran apa pun ikut dihapus.
404Tidak ada pesan terjadwal dengan tid tersebut di akun Anda
409Sudah terkirim, sedang dikirim, atau sudah dibatalkan

Pembatalan ditangani dengan aman terhadap dispatcher: jika pengiriman sudah dimulai, Anda mendapat 409 alih-alih pesan yang setengah dibatalkan.

Aturan yang perlu diketahui ​

Batas waktu ke depan adalah 30 hari. Waktu yang lebih jauh akan ditolak.

Waktu di masa lalu mengembalikan 400, dengan toleransi 60 detik untuk perbedaan jam. Dalam rentang itu, pesan langsung dikirim.

Level dan paket ditentukan saat penjadwalan, bukan saat pengiriman. Pesan yang dijadwalkan sebagai critical pada paket berbayar tetap tiba sebagai critical meskipun paket berakhir di antara waktu tersebut. Penjadwalan adalah sebuah janji.

Batas harian dihitung saat penjadwalan. Pesan terjadwal dihitung ke batas pesan harian pada hari Anda menjadwalkannya, bukan pada hari pengirimannya — dan pengiriman tidak pernah diblokir oleh batas. Jika melampaui batas, permintaan penjadwalan itu sendiri mengembalikan 429. Pembatalan tidak mengembalikan kuota.

Lampiran diunggah saat penjadwalan dan ditautkan ke pesan saat pengiriman. Pembatalan menghapus file yang tersimpan.

Pesan yang terlambat dikirim terlambat, bukan dibuang. Jika layanan restart melewati waktu pengiriman, pesan akan dikirim pada siklus berikutnya alih-alih hilang.

Konten dienkripsi saat disimpan menggunakan kunci pribadi Anda sejak saat Anda menjadwalkannya, sama seperti pesan biasa.

Fitur berbayar

Pengiriman terjadwal tersedia pada paket berbayar. Permintaan paket gratis dengan send_at atau delay mengembalikan 403 — tidak ada yang diabaikan secara diam-diam.

Terkait ​

Dokumentasi Pocket Alert