Bildirim gönderme

POST https://api.pushbell.app/v1/messages — gövde JSON, form (application/x-www-form-urlencoded) veya multipart/form-data olabilir. Anahtar Authorization: Bearer başlığında.

Alan	Açıklama
`title`	Başlık (en fazla 250 karakter). Yoksa tipin başlığı, yoksa proje adı.
`message`	Metin (paketine göre 4.000 karaktere kadar).
`type`, `vars`	Bildirim tipi ve şablon değişkenleri.
`priority`	`-2` sessiz kayıt · `-1` sessiz · `0` normal · `1` yüksek (sessiz saatleri deler) · `2` acil (onaylanana kadar tekrar eder).
`sound`	Ses adı: hazır ses (`cash`, `bell`, `alarm`…), panelden yüklediğin özel ses, `vibrate` veya `none`. Pushover ses adları da çalışır.
`url`, `url_title`	Bildirime eklenen bağlantı.
`actions`	En fazla 3 buton (sayı paketine göre): `{"title": "Kapıyı aç", "kind": "http", "url": "https://…"}` veya `{"kind": "open_url", …}`. `open_url` cihazda bağlantıyı açar. `http` butonunun adresi cihaza hiç gitmez: basılınca PushBell sunucusu bu adrese imzalı `POST` atar (webhook imzası).
`attachment` (multipart), `attachment_base64` + `attachment_type`, `image_url`	Görsel. Ek işlenir (EXIF yönü uygulanır ve konum gibi bilgiler silinir, en uzun kenar 1440 px), bildirimde ve gelen kutusunda gösterilir; mesajla birlikte silinir.
`timestamp`	Olayın gerçek zamanı (unix saniye); alınma zamanı yerine gösterilir.
`group`, `badge`	Bildirim grubu (iOS’ta aynı konu, Android’de aynı grup) ve uygulama rozeti (sayı veya `+1`).
`html`, `monospace`	Sınırlı HTML (`b`, `i`, `u`, `font color`, `a`) veya sabit genişlikli yazı.
`to`	Kullanıcı (`u_…`) veya grup (`g_…`) anahtarları. Yoksa projenin varsayılan kitlesi.
`device`	Sadece bu cihaz adlarına veya etiketlerine.
`ttl`	Saniye: bildirim teslimden bu kadar sonra cihazlardan ve gelen kutusundan silinir (ör. tek kullanımlık kod).
`expire_at`	Bu zamana kadar teslim edilemezse hiç gönderilmez.
`send_at`	Zamanlanmış gönderim.

Yanıt:

{ "status": 1, "id": "01a17a88-3ed9-76aa-9ed9-1b312156d5cc" }

Kota durumu yanıt başlıklarında gelir: X-Limit-App-Limit, X-Limit-App-Remaining, X-Limit-App-Reset (yaklaşık).

Bildirim tipleri

Panelde bir proje için tip tanımlarsın (ör. sale, alarm); istekte type verince tipin ayarları kullanılır:

Şablon: {{amount}} satış gibi başlık / metin, vars ile doldurulur.
Ses, logo ve renk (renk Android’de bildirimin rengi).
Öncelik: ör. alarm tipi acil olabilir. İstekte priority yoksa tipinki geçer; tip acilse tekrar aralığı ve süresi de tipten gelir. Bu durumda makbuz yanıtta dönmez; makbuz panelin mesaj kaydında ve mesajın ayrıntısında görünür.
Link, link başlığı, butonlar ve ttl.
Özetleme: art arda gelenler tek özette toplanır.

İstekte verilen alan her zaman tipinkinin önüne geçer. Panelde tipi kaydettikten sonra Kendime dene ile kendi cihazlarında görebilirsin; bu deneme kotadan düşmez.

Toplu gönderim: POST /v1/messages/batch ile tek istekte 500’e kadar bildirim; biri hatalıysa hiçbiri kuyruğa alınmaz. Tüm alanlar için API referansı.