# Kirim push notification dari backend Anda.

> Kirim push notification dari backend Anda dengan API Pocket Alert. Satu HTTP POST terautentikasi dari Node, Python, PHP, atau Go langsung sampai ke HP Anda dalam sekejap.

<!-- source: https://pocketalert.app/id/use-cases/api-alerts -->

Terakhir diperbarui: 2026-08-11

API Pocket Alert mengirim push notification ke ponsel Anda dengan satu HTTP POST terautentikasi. Panggil dari Node, Python, PHP, atau Go dengan title, message, dan level prioritas, lalu notifikasi langsung sampai ke iPhone atau Android Anda.

## Tiga langkah menuju push API pertama Anda

1. **Dapatkan kunci API** — Buat kunci API di halaman API Keys dan simpan di variabel lingkungan.
2. **Kirim permintaan** — Kirim title dan message dalam JSON ke endpoint pesan dengan kunci di header Token.
3. **Jalankan** — Ponsel Anda bergetar dalam waktu satu detik. Tambahkan penargetan aplikasi dan perangkat seiring kebutuhan Anda bertambah.

## Notifikasi, cukup satu permintaan

API ini menggerakkan setiap notifikasi Pocket Alert. Hubungkan ke backend Anda hanya dengan satu permintaan.

- **REST biasa, tanpa SDK** — Satu POST terautentikasi mengirim push dari HTTP client yang sudah Anda gunakan. Tanpa SDK, antrean, atau broker.
- **Bahasa apa pun** — Node, Python, PHP, Go, dan Ruby semuanya dapat memicu notifikasi Pocket Alert.
- **Autentikasi berbasis kunci** — Kunci API Anda dikirim di header Token melalui HTTPS. Buat, batasi, dan rotasi kunci sesuai jadwal Anda sendiri.
- **Kontrol penuh** — Arahkan dengan application_id dan targetkan satu device_id, atau hilangkan untuk menjangkau semua perangkat, dalam satu panggilan.
- **Pengiriman di bawah satu detik** — Push sampai ke iPhone atau Android Anda dalam waktu jauh di bawah satu detik, cukup cepat untuk memicu notifikasi backend secara real-time.
- **Siap CLI & webhook** — API yang sama juga menggerakkan CLI dan webhook. Mulai dengan kode, lalu tambahkan salah satunya nanti.

## Kirim notifikasi API pertama Anda

### 1. Dapatkan kunci API

Buat kunci di halaman [API Keys](https://pocketalert.app/id/account/apikeys) dan kirim di header `Token` pada setiap permintaan.

### 2. Kirim POST pesan

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Order shipped","message":"Order #1024 is on its way","application_id":"qm47b9pzxzxg"}'
```

### 3. Dari kode Anda

Panggil dari mana pun endpoint mengalami error atau event kustom terjadi, misalnya setelah health check gagal atau pesanan baru masuk:

```
await fetch("https://api.pocketalert.app/v1/messages", {
  method: "POST",
  headers: { Token: process.env.POCKETALERT_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "API health check failed",
    message: "GET /v1/orders returned 500",
    application_id: "qm47b9pzxzxg",
    level: "high",
  }),
});
```

Dokumentasi [getting-started](https://info.pocketalert.app/getting-started.html) lengkap membahas penargetan aplikasi dan perangkat.

## FAQ

### Bagaimana cara mengirim notifikasi via API?

Kirim POST ke API pesan Pocket Alert dengan kunci Anda di header Token dan body JSON yang berisi title serta message. Notifikasi langsung masuk ke ponsel Anda.

### Bagaimana cara kerja autentikasi API?

Lakukan autentikasi dengan kunci API dari halaman Pengaturan, dikirim di header Token melalui HTTPS. Buat dan rotasi kunci kapan pun Anda perlu, lalu batasi notifikasi per aplikasi.

### Bahasa apa saja yang didukung?

Bahasa apa pun yang bisa membuat permintaan HTTP dapat digunakan: Node, Python, PHP, Go, Ruby, dan Rust. Tidak ada yang perlu dipasang, cukup panggilan REST biasa dari HTTP client yang sudah Anda gunakan.

### Apa saja yang bisa saya atur dalam permintaan?

Atur title dan message, arahkan ke aplikasi tertentu dengan application_id, targetkan satu perangkat dengan device_id (atau hilangkan untuk menjangkau semua perangkat), dan atur prioritas dengan level, dari silent hingga critical. Pesan critical akan menembus mode Jangan Ganggu di Android dan melewati Fokus di iPhone.

### Apakah ada opsi CLI atau webhook juga?

Ya. CLI Pocket Alert membungkus API yang sama untuk skrip dan CI. Jika Anda ingin tanpa kode, buat webhook dan arahkan layanan ke URL penerimanya.
