Widget ve saat kadranı

Bildirim göndermeden, bir değeri sürekli göz önünde tutabilirsin: günün cirosu, açık destek talepleri, sunucunun yükü, yedeklemenin yüzdesi. Değer şuralarda görünür:

• iPhone ve Android: ana ekrandaki PushBell widget’ı.
• Apple Watch: saat uygulamasının en üstü ve kadrandaki PushBell (dairesel, köşe, dikdörtgen, satır).
• Wear OS: PushBell kutucuğu ve kadran verisi.

Widget değeri gönderilmemişse bu yerler okunmamış bildirim sayısını ve son bildirimleri gösterir.

Gönderme

curl -X POST https://api.pushbell.app/v1/glances \
  -H "Authorization: Bearer pb_live_…" -H "Content-Type: application/json" \
  -d '{"title": "Bugün", "text": "12.450 TL", "subtext": "38 sipariş", "count": 38, "percent": 62}'

Alan	Açıklama
title	Değerin adı (“Bugün”, “Kuyruk”); en fazla 100 karakter
text	Ana satır; en fazla 100 karakter
subtext	İkinci satır; en fazla 100 karakter
count	Tam sayı, eksi olabilir; küçük ekranlarda (kadran) bu gösterilir
percent	0–100; ilerleme çubuğu ya da halkası
to	Ekibindeki bir kişinin kullanıcı anahtarı (u_…). Yoksa çalışma alanının sahibi
device	Sadece o kişinin bu cihazı (cihazın uygulamadaki adı)

En az bir değer alanı gerekir. Gönderdiğin alanlar eskilerinin yerine geçer, göndermediklerin aynen kalır; bir alanı silmek için null gönder:

{ "percent": null, "text": "Yedek bitti" }

Ne sıklıkla

Aynı kişiye (ya da cihaza) dakikada en fazla bir güncelleme iletilir; arada gelenler birleşir, son değer gider. Değeri her olayda değil, anlamlı aralıklarla (ör. 5 dakikada bir ya da değer değişince) gönder.

• Android ve Wear OS: genelde birkaç saniye içinde güncellenir; telefon derin uykudaysa Android geciktirebilir. Cihaz çevrimdışıysa yalnızca son değer bekler.
• iPhone ve Apple Watch: iOS arka plan güncellemelerini pil bütçesine göre geciktirebilir; uygulama açılınca değer hemen tamamlanır.

Acil ya da anında görülmesi gereken şeyler için widget değil bildirim gönder.

Widget’ı eklemek

• Uygulamada: Ayarlar → Ana ekrana widget ekle. Android’de widget doğrudan eklenir; iPhone’da ana ekrana uzun bas, Düzenle → Widget ekle → PushBell.
• Apple Watch: kadrana uzun bas, Düzenle ile bir alana PushBell’i seç.
• Wear OS: kutucuklara PushBell’i ekle; kadranın veri alanında PushBell’i seç.

Pushover’dan

Pushover’ın Glances API’si de çalışır: POST https://api.pushbell.app/1/glances.json (token, user, device, title, text, subtext, count, percent). Pushover’daki gibi boş değer alanı temizler.