İçeriğe geç

Gruplar

Grup, birden çok kişiyi tek bir anahtarda toplar. Bildirimde to alanına grubun anahtarını (g_…) yazarsın, gruptaki herkese gider. Kimin grupta olduğunu değiştirmek için kodunu değiştirmen gerekmez.

{ "title": "Sunucu çöktü", "message": "api-1 yanıt vermiyor", "priority": 1, "to": ["g_7mGmq2pVtR1DkW8xZb0sYcLnQe4uFj"] }

to boşsa bildirim projenin varsayılan kitlesine gider. Bir grubu yalnızca aynı çalışma alanının projeleri kullanabilir.

Gruplar → Yeni grup: ad ver, grubun anahtarı oluşur. Üye ekle ile kişileri ekle:

  • Kullanıcı anahtarı: kişi uygulamada Ayarlar → Kullanıcı anahtarın’dan kopyalar (u_…). Projene abone olan birinin projeye özel anahtarı da olur.
  • Cihaz: sadece kişinin bu cihazına gönderilsin (cihazın uygulamadaki adı). Aynı kişiyi farklı cihazlarla ayrı ayrı ekleyebilirsin.
  • Not: en fazla 200 karakter; sadece panelde görünür (“nöbetçi”, “depo sorumlusu”).
  • Durdur: üye gruptan çıkmadan bildirim almayı bırakır (izin, tatil); Başlat ile geri döner.

Üyelerin e-postası hiçbir yerde görünmez, yalnızca anahtarları.

Takım grubu kendiliğinden vardır: ekibine katılan herkes içindedir, ekipten çıkan düşer. Takım grubuna elle üye eklenmez, silinemez; üyeleri durdurulabilir.

Kaç grup kurabileceğin paketine bağlı.

Proje API anahtarıyla:

İstek Ne yapar
GET /v1/groups Gruplar
POST /v1/groups {"name": "Nöbet"} Grup oluşturur, anahtarı döner
GET /v1/groups/{g_…} Grup ve üyeleri
PATCH /v1/groups/{g_…} {"name": "…"} Adını değiştirir
DELETE /v1/groups/{g_…} Grubu siler
POST /v1/groups/{g_…}/members {"user": "u_…", "device": "iphone", "memo": "…"} Üye ekler
PATCH /v1/groups/{g_…}/members/{id} {"disabled": true} Üyeyi durdurur / başlatır, cihazını ya da notunu değiştirir
DELETE /v1/groups/{g_…}/members/{id} Üyeyi çıkarır

Nöbet çizelgesini kendi sisteminden yönetiyorsan her vardiya başında üyeleri durdurup başlatman yeter; bildirimleri gönderen kod hep aynı grup anahtarını kullanır.

Pushover’ın grup API’si de çalışır (/1/groups.json, add_user, delete_user, disable_user, enable_user, rename): Pushover uyumluluğu.