Apa itu push notification API, dan kapan Anda membutuhkannya?

Push notification API adalah layanan web yang menampilkan pesan di layar kunci ponsel saat kode Anda memintanya. Anda mengirim satu permintaan HTTP dengan judul dan isi pesan, layanan tersebut meneruskannya ke Apple atau Google, dan ponsel menampilkannya dalam hitungan detik, meskipun tidak ada aplikasi yang terbuka.
Itulah inti idenya. Detailnya terletak pada siapa penerima notifikasi tersebut, dan seberapa banyak bagian dari rantai pengiriman yang ingin Anda kendalikan sendiri.
Dua hal berbeda yang berbagi nama
Cari "push notification API" dan Anda akan menemukan dua jenis produk yang hampir tidak tumpang tindih.
Platform yang mengirim ke pengguna Anda. Firebase Cloud Messaging, Apple Push Notification service, OneSignal, dan sejenisnya. Anda membangun aplikasi seluler, merilisnya ke App Store dan Google Play, mengumpulkan token perangkat dari setiap instalasi, lalu mengirim notifikasi produk atau pemasaran kepada ribuan orang. API ini adalah langkah terakhir dari proyek yang panjang.
Layanan yang mengirim ke Anda. Pocket Alert, Pushover, ntfy, dan lainnya. Aplikasinya sudah ada: Anda memasangnya di ponsel sendiri, mendapatkan kunci API, dan mengirim peringatan dari skrip, server, dan layanan lain. Tidak perlu menerbitkan apa pun, tidak perlu mengumpulkan token. Deployment selesai, backup gagal, atau pembayaran masuk.
Panduan ini membahas jenis kedua. Jika Anda membangun aplikasi konsumen dan perlu menjangkau penggunanya, Anda membutuhkan jenis pertama, dan sebagian besar isi panduan ini tidak akan berlaku.
Apa yang terjadi saat Anda mengirim satu notifikasi
Empat tahap, sebagian besar tidak terlihat:
- Kode Anda mengirim permintaan HTTPS ke layanan dengan judul, pesan, dan kunci API Anda.
- Layanan memeriksa kunci, menyimpan pesan, dan memutuskan ke mana pesan itu dikirim: perangkat mana di antara milik Anda, dengan prioritas apa.
- Layanan meneruskan notifikasi ke jaringan push milik platform, APNs untuk iPhone dan Firebase Cloud Messaging untuk Android.
- Apple atau Google mengirimkannya melalui koneksi yang sudah selalu dibuka oleh setiap ponsel ke mereka, lalu ponsel menampilkannya.
Tahap 3 dan 4 adalah alasan push tetap berfungsi saat aplikasi tertutup dan tidak menguras baterai: ponsel tidak pernah melakukan polling ke siapa pun. Jalur lengkapnya dijelaskan di Cara kerja push notification: APNs dan FCM.
Mengapa tidak langsung berkomunikasi dengan Apple dan Google?
Anda bisa melakukannya, jika Anda memiliki aplikasi sendiri di kedua toko aplikasi. Untuk mengirim ke ponsel Anda sendiri tanpa perantara, Anda membutuhkan:
- Keanggotaan Apple Developer Program dan aplikasi iOS yang dibangun dengan entitlement push, ditambah proyek Firebase dan aplikasi Android untuk sisi lainnya.
- Kunci penandatanganan APNs dan akun layanan Firebase, serta kode yang menandatangani permintaan untuk masing-masing.
- Cara untuk mengumpulkan token perangkat dari aplikasi dan menjaganya tetap mutakhir ketika berubah.
- Dua format permintaan, dua model prioritas, dan dua set kode error.
Itu proyek yang wajar jika aplikasinya adalah produk Anda. Tetapi itu terlalu banyak mesin hanya untuk "beri tahu saya saat cron job gagal". Layanan push notification sudah melakukan semua itu sekali, untuk semua orang.
Seperti apa bentuk permintaannya
Dengan Pocket Alert, mengirim notifikasi cukup satu POST yang terautentikasi:
curl -X POST https://api.pocketalert.app/v1/messages \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title": "Deploy finished", "message": "api v2.4.1 is live"}'
Responsnya adalah 201 Created dengan pesan yang tersimpan dan prioritas saat pesan dikirim. Permintaan yang sama bisa dijalankan dari bahasa apa pun yang memiliki klien HTTP, dan Kirim push notification dengan curl berisi lebih banyak contoh untuk terminal.
Hanya title dan message yang wajib. Field opsional yang paling penting untuk peringatan:
levelmenentukan seberapa keras notifikasi itu berbunyi:silent,low,default,high, ataucritical.actionsmenambahkan hingga tiga tombol aksi ke notifikasi: membuka URL, memicu permintaan HTTP, atau menyalin nilai.send_atataudelaymengirimkannya nanti, bukan sekarang (paket berbayar).application_iddandevice_idmenentukan proyek mana yang dimaksud dan ponsel mana yang menerimanya.
Tiga cara masuk, bukan hanya API
Push notification API paling berguna saat Anda tidak perlu menulis kode untuk setiap sumber.
- HTTP API untuk skrip, tugas, dan aplikasi Anda sendiri.
- URL webhook untuk layanan yang sudah mengirim webhook. GitHub, Stripe, Grafana, atau Sentry mengirim JSON mereka sendiri ke URL webhook Pocket Alert, dan placeholder seperti
%repository.name%mengambil field dari JSON tersebut ke dalam notifikasi, tanpa kode di tengah. Buat URL webhook pertama Anda menjelaskan langkahnya. - CLI dan server MCP untuk terminal dan agen AI:
pocketalert send "Build done" "All tests passed"dari shell (CLI), atau toolcreate_messageyang dipanggil Claude atau Cursor saat tugas panjang selesai (MCP).
Di mana Anda akan menggunakannya
Sebagian besar peringatan termasuk dalam beberapa kelompok:
- Ada yang rusak. Server berhenti merespons, cron job keluar dengan kode non-nol, backup tidak berjalan. Lihat peringatan cron job dan pemantauan server.
- Ada yang selesai. Deployment, build panjang, cetakan 3D 12 jam, atau tugas agen AI. Lihat peringatan deployment.
- Ada yang terjadi dan penting bagi Anda. Pembayaran, pendaftaran, atau pengiriman formulir. Lihat peringatan pembayaran dan peringatan pendaftaran.
- Ada yang akan terjadi. Sertifikat yang kedaluwarsa dalam 14 hari. Lihat peringatan kedaluwarsa SSL.
Benang merahnya adalah peristiwa yang perlu diketahui seseorang sekarang, bukan saat mereka membuka dasbor atau kotak masuk berikutnya.
Yang perlu diperiksa sebelum memilih
Setiap layanan di bidang ini mengirim push dari permintaan HTTP. Perbedaannya ada pada segala hal di sekitarnya:
- Platform. Beberapa hanya untuk iPhone (Bark, The Notification App), dan aplikasi resmi Gotify hanya untuk Android. Jika orang yang perlu menerima peringatan memakai ponsel yang lain, itu sudah menentukan pilihan.
- Tingkat prioritas. Apakah backup yang gagal bisa berbunyi berbeda dari pendaftaran baru? Apakah peringatan kritis bisa menembus Jangan Ganggu?
- Webhook masuk. Apakah layanan bisa mengirim JSON-nya sendiri, atau setiap sumber memerlukan skrip untuk mengubah bentuknya?
- Riwayat dan log. Ketika sebuah peringatan tidak sampai, apakah ada catatan tentang panggilan tersebut dan apa yang terjadi padanya?
- Batas dan harga. Per hari, per bulan, atau seumur hidup, dan apa yang terjadi saat batas tercapai.
- Siapa yang menjalankannya. Layanan hosting, atau server yang Anda pelihara sendiri.
Kami membandingkan Pocket Alert dengan Pushover, ntfy, Pushbullet, Bark, Gotify, dan lainnya tepat pada poin-poin ini di Alternatif, termasuk tempat masing-masing menjadi pilihan yang lebih baik.
FAQ
Apakah push notification API sama dengan Firebase Cloud Messaging?
FCM adalah salah satu push notification API: yang disediakan Google untuk aplikasi yang Anda bangun dan terbitkan. Layanan seperti Pocket Alert berada di atas FCM dan APNs, lalu mengurus aplikasi, kunci, dan token perangkat, sehingga yang perlu Anda buat hanyalah permintaan HTTP.
Apakah saya perlu membangun aplikasi seluler?
Tidak untuk peringatan ke diri sendiri atau tim Anda. Anda cukup memasang aplikasi yang sudah ada, seperti Pocket Alert untuk iPhone atau Android, lalu mengirim ke sana. Anda hanya memerlukan aplikasi sendiri jika ingin mengirim ke pengguna Anda sendiri.
Apakah gratis?
Banyak layanan memiliki paket gratis. Paket gratis Pocket Alert memberi 50 pesan per hari tanpa kartu kredit, yang mencukupi untuk sebagian besar peringatan pribadi, dan paket berbayar mulai dari $6 per bulan untuk 1.000 pesan per hari. Rinciannya ada di halaman harga.
Seberapa cepat pengirimannya?
Biasanya beberapa detik dari permintaan hingga layar kunci. Namun Apple dan Google tidak menjamin waktunya: ponsel tanpa sinyal atau dalam mode hemat baterai yang ketat akan menerima notifikasi saat tersambung kembali.
Push, SMS, atau email?
Push untuk hal yang perlu perhatian sekarang, email untuk ringkasan dan catatan, SMS saat orang tersebut tidak memiliki aplikasi di smartphone sama sekali. Pertimbangannya dijelaskan di Push notification vs SMS dan Push notification vs peringatan email.
Buat akun gratis, salin kunci API Anda, dan perintah curl di atas adalah push pertama Anda.