Pushover'dan geçiş

PushBell, Pushover’ın mesaj API’sini birebir kabul eder. Mevcut entegrasyonun için:

1. Panelde API anahtarları → Anahtar oluştur ekranında Pushover uyumlu (30 karakter) seçeneğini işaretle.
2. İstek adresini https://api.pushover.net/1/messages.json yerine https://api.pushbell.app/1/messages.json yap.
3. token olarak yeni anahtarı, user olarak PushBell kullanıcı anahtarını (u_…, panelde Hesap sayfasında) kullan.

Parametreler (title, message, priority, sound, url, retry, expire, callback, html, attachment…) ve yanıtlar ({"status":1,"request":"…"}, hatada errors dizisi) aynıdır. Pushover ses adları (cashregister, siren, persistent…) en yakın PushBell sesine eşlenir.

Pushover’ın diğer uçları da aynı adreslerle çalışır:

Uç	Ne yapar
GET /1/receipts/{receipt}.json, POST /1/receipts/{receipt}/cancel.json, POST /1/receipts/cancel_by_tag/{tag}.json	Acil bildirim makbuzu: durum, iptal, etiketle iptal
POST /1/users/validate.json	Kullanıcı ya da grup anahtarını doğrular; cihaz adlarını (devices) ve platformlarını (licenses) döner
GET /1/sounds.json	Hazır sesler ve özel seslerin
GET /1/apps/limits.json	Aylık hak: limit, remaining, reset
POST /1/glances.json	Widget verisi: title, text, subtext, count, percent; boş değer alanı temizler
/1/groups.json, /1/groups/{key}.json, …/add_user.json, delete_user, disable_user, enable_user, rename	Gruplar
POST /1/subscriptions/migrate.json	Kullanıcı anahtarını abone anahtarına çevirir
GET /1/teams.json, POST /1/teams/add_user.json, revoke_invitation.json, remove_user.json	Pushover for Teams: ekip bilgisi, davet, davet iptali, ekipten çıkarma. Anahtarı panelde Ekip yönetimi işaretiyle oluştur (yalnızca yöneticiler); bu anahtar bildirim gönderemez. add_user e-postayla davet gönderir, hesabı olmayan kişi linkle şifresiz hesap açar; password kullanılmaz, kişi takım grubuna kendiliğinden girer

Açık İstemci API’si (bildirim almak)

Pushover’ın Açık İstemci API’siyle yazılmış masaüstü ve Linux istemcileri ya da kendi yazılımın PushBell’den bildirim alabilir. Adresleri değiştirmen yeter:

Pushover	PushBell
https://api.pushover.net/1/…	https://api.pushbell.app/1/…
wss://client.pushover.net/push	wss://ws.pushbell.app/push
https://api.pushover.net/icons/…, /sounds/…	https://api.pushbell.app/icons/…, /sounds/…

1. Giriş: POST /1/users/login.json (email, password). İki adımlı doğrulama açıksa yanıt HTTP 412 olur; isteği twofa ile (doğrulayıcı uygulamadaki kod ya da kurtarma kodu) tekrarla. Yanıttaki secret’ı sakla, şifreyi saklama. Bu giriş hesabının Oturumlar listesinde görünür. Oradan kapatırsan istemci yeniden giriş ister.
2. Cihaz: POST /1/devices.json (secret, name, os=O). Ad en fazla 25 karakter: harf, rakam, _ ya da -. Ad alınmışsa hata döner. Bu istemciyle daha önce kaydettiğin cihazı force=1 ile yeniden kullanırsın.
3. Dinle: wss://ws.pushbell.app/push’a bağlan, login:<cihaz>:<secret> ve satır sonu gönder. Sunucu tek baytlık çerçeveler yollar:
   • # canlı tutma
   • ! yeni bildirim var: indir (bağlanınca da gelir, bağlı değilken gelenler için)
   • R yeniden bağlan
   • E kalıcı hata: tekrar giriş yap ya da cihazı yeniden kaydet
   • A cihaz başka bir bağlantıdan bağlandı: yeniden bağlanma
4. İndir: GET /1/messages.json?secret=…&device_id=…. Bir seferde en fazla 100 bildirim gelir. Alanlar Pushover’la aynı: id, umid, title, message, app (proje), icon, date, priority, sound, url, url_title, acked, receipt, html.
5. Sil: POST /1/devices/<cihaz>/update_highest_message.json (secret, message: son indirmedeki en büyük id). Silmediğin bildirimler sonraki indirmede yine gelir.
6. Acil bildirimi onayla: POST /1/receipts/<receipt>/acknowledge.json (secret). Sadece kişi bildirimde bir butona bastığında gönder, süre dolunca gönderme.
7. Çıkış (PushBell eki): POST /1/users/logout.json (secret). Oturum sunucuda kapanır, cihaz pasifleşir ve artık bildirim almaz. Sadece yerel dosyayı silmek yetmez: secret bir yıl geçerli kalır.

• icon boşsa istemci default.png ister (PushBell simgesi). Projenin ya da tipin logosu varsa icon logonun kodudur: /icons/<kod>.png.
• sound hazır sesin adı ya da özel sesin kodudur: /sounds/<ad>.mp3.
• Simge ve ses dosyaları yönlendirmesiz, doğrudan döner; kodlu dosyalar değişmez, önbelleğe alabilirsin.
• Uçtan uca şifreli bildirimlerin metni istemciye gelmez; “Şifreli bildirim” yazar, okumak için PushBell uygulamasını açarsın.