İçeriğe geç

Hızlı başlangıç

PushBell, sitenden ve sistemlerinden gelen bildirimleri iPhone, Android ve diğer cihazlarına iletir. Her bildirim tipine kendi logosunu, sesini ve bağlantısını verebilirsin.

  1. app.pushbell.app adresinde hesap oluştur. Kayıtta ilk projen hazır gelir.

  2. Telefonuna PushBell uygulamasını kur ve aynı hesapla giriş yap. Bildirim iznini ver.

  3. Panelde projenin Genel bakış sayfasından bir API anahtarı oluştur. Anahtar sadece bir kez gösterilir.

  4. İlk bildirimini gönder:

    Terminal window
    curl -X POST https://api.pushbell.app/v1/messages \
    -H "Authorization: Bearer pb_live_…" \
    -H "Content-Type: application/json" \
    -d '{"title":"Yeni sipariş","message":"1.250 TL tutarında sipariş geldi"}'

    Yanıt 202 Accepted ve bildirimin kimliğidir. Bildirim kuyruğa yazılmıştır; birkaç saniye içinde cihazlarına ulaşır. Panelin Gönderim kaydı bölümünde durumunu görebilirsin.

Her olay için bir tip tanımla (sale, signup, server_down…). Tipin logosu, sesi, başlık ve metin şablonu, bağlantısı panelden ayarlanır; istekte sadece tipi ve değişkenleri gönderirsin:

{ "type": "sale", "vars": { "amount": "1.250 TL" } }

Tipin başlık şablonu {{amount}} satış ise bildirim “1.250 TL satış” olarak gelir. İstekte verilen alanlar tipin ayarlarının yerine geçer.

Geçerli her istek kuyruğa yazılır ve teslim edilir; yoğunluk yüzünden reddedilmez, sunucularımız kapalıyken bile kaybolmaz. API sadece hatalı istek (400), geçersiz anahtar (401) ve etkin paketi olmayan hesap (402) durumunda hata döner. Tekrar denemelerin güvenli olması için Idempotency-Key başlığı gönder: aynı anahtarla 24 saat içinde gelen istek bir kez teslim edilir.