Push bildirim API belgeleri

Yayın sisteminiz bildirimi kendisi göndersin. Panele girmeden, tek bir POST isteğiyle.

1. Kurulum: siteye eklenen kod

Panelden aldığınız tek satırı sitenizin head alanına ekleyin. Anahtar ve alan adı kodun içinde gelir; elle düzenlemeniz gereken bir yer yoktur.

<script src="https://bildirim.pusnet.com/js/ANAHTARINIZ.js" defer></script>

Bu betik izin kutusunu, service worker kaydını ve abonelik çağrısını birlikte getirir. Sunucunuza ayrıca bir service worker dosyası koymanız gerekiyorsa panel onu da üretir.

2. Anahtar türleri

İki tür anahtar vardır ve karıştırılmamalıdır:

• Yayımlanabilir anahtar — sitenizin kaynağında açıkta durur. Yalnız abonelik açar.
• Gizli anahtar — bildirim gönderir. Yalnız sunucunuzda dursun, tarayıcıya konulmaz. Tarayıcıya konan gizli anahtarla herkes sizin adınıza bildirim gönderebilir.

3. Bildirim gönderme

POST https://bildirim.pusnet.com/gonder
x-api-key: GIZLI_ANAHTARINIZ
content-type: application/json

{
  "baslik": "Antalya için sağanak uyarısı",
  "govde": "Meteoroloji akşam saatleri için uyardı.",
  "url": "https://siteniz.com/haber/saganak",
  "gorselUrl": "https://siteniz.com/gorsel/saganak.jpg",
  "hedef": { "tur": "sehir", "deger": "Antalya" }
}

Başarılı yanıt 202 döner; bildirim kuyruğa alınır ve hedef kitle sayısıyla birlikte bir kimlik verilir:

{ "ok": true, "bildirimId": "…", "hedefAdet": 1240, "durum": "kuyrukta" }

4. Hedefleme

Şehir, okuyucunun bağlantı konumundan kendiliğinden belirlenir; ayrıca bir şey yapmanız gerekmez. Tanınmayan il adı sessizce boş kitleye gitmez, 422 ile reddedilir — yanlış yazılmış bir il yüzünden bildirimin kimseye ulaşmaması en kötü hata türüdür.

5. İleri tarihli gönderim

planlananAt alanına ISO 8601 biçiminde ileri bir zaman verin; bildirim o zamana kadar bekletilir.

"planlananAt": "2026-10-10T07:00:00+03:00"

6. Yanıt kodları

Kota aşımında bildirim kaybolmaz: kaydedilir ve durumu sebebi söyler.

7. Alan adı esnekliği

İçerik yönetim sistemleri aynı şeye farklı adlar veriyor. title, message, description gibi yaygın adlar kabul edilip kendi alanlarımıza çevrilir; tek harf yüzünden entegrasyonun çalışmaması gerekmez.

Ücretsiz anahtar alın