PushizoDocs
API reference

API changelog

Release notes about the public REST API, SDKs and webhooks (filtered from CHANGELOG.md).

Contract policy: only backward-compatible additions are made under /v1; breaking changes ship under a new version path (versioning). For every product change see the release notes.

The release-note entries below are published in Turkish, the language the changelog is written in.

Yayınlanmamış

Düzeltildi

  • Google ve Apple ile giriş, panel ve API ayrı alan adlarındayken oturum açmıyordu (ADR-0096 eki).

Eklendi (Faz 68 — yapay zekâ ile kurulum)

  • MCP sunucusu: create_app, get_setup_status, get_sdk_snippet (228 → 231 araç). Asistan app'i oluşturur, panel rehberiyle aynı kurulum kodunu verir ve ilk aboneyi doğrular (ADR-0097).
  • Yerel (stdio) MCP sunucusu: upload_channel_credentials. Push anahtarı (.p8, .p12, Firebase servis hesabı) dosya yolundan yüklenir; içerik sohbete ve araç çıktısına girmez. Dosyalar yalnız çalışma dizini ya da PUSHIZO_CREDENTIALS_DIR altından okunur.
  • Public API: POST /v1/mcp/apps, GET /v1/apps/{app}/setup/status, GET /v1/apps/{app}/setup/snippet. Sunucu SDK'larında karşılıkları (Node ve PHP: apps.setupStatus, apps.setupSnippet, mcp.createApp).
  • @pushizo/mcp-server ve @pushizo/cli 0.4.0 npm'de yayında (2026-11-18; SDK'lar 0.3.0'da kalır).

SDK 0.3.0 (yayımlandı: 2026-11-18)

  • Tüm SDK'lar 0.3.0 sürümüne yükseltildi ve yayımlandı (Android dahil; önceki Android sürümü 0.2.1): npm, Maven Central (Android, Java, KMP), CocoaPods/SPM, PyPI, RubyGems, NuGet (Pushizo, Pushizo.Maui), Packagist, Go, pub.dev, Unity. .NET MAUI ve Kotlin Multiplatform ilk kez kayıt defterinde. crates.io (Rust) ve MCP Registry (com.pushizo/mcp) de 0.3.0. Köprüler yerel Android ve iOS 0.3.0'a, React/Vue/Angular ve Capacitor @pushizo/web 0.3.0'a bağlıdır.
  • İçerik: aşağıdaki "kapsam tamamlama" ve "Faz 67a–67b" bölümlerindeki SDK değişiklikleri (Android teslimat güçlendirme, site araması, içerik kartı görünümü, hazır sohbet arayüzü, gözlemciler, profille login, sunucu SDK'larında 518 işlem).

Eklendi (kapsam tamamlama ve sosyal giriş)

  • Public API: gelen kutusu takım ve atama kuralları, reklam kampanyası ve kreatif oluşturma, e-posta geri dönüşleri ve liste hijyeni, oturum analitiği, son olaylar, kullanıcı zaman akışı, abonelik listesi ve temizliği, webhook olay türleri ve yeniden oynatma, form/anket/açılış sayfası yönetimi (ADR-0095). Toplam 518 işlem; tüm sunucu SDK'larında karşılığı var.
  • MCP sunucusu: 73 → 228 araç (Faz 55–67 yetenekleri dahil); yazma araçları yalnız taslak üretir.
  • İstemci SDK'ları: Web'de içerik kartı görünümü, özel in-app çizici, rozet ve profille login; iOS ve Android'de User.setProperty, özellik bayrağı ve gelen kutusu gözlemcileri, hazır sohbet arayüzü. Köprü SDK'lar (Flutter, React Native, Capacitor, Cordova, Unity, MAUI, KMP) ve React/Vue/Angular sarmalayıcıları yerel API'lerle eşitlendi; köprülere Android Delivery API'si eklendi.

Değişti

  • Köprü SDK'larda rozet çağrıları (setBadgeCount, clearBadge) Flutter, React Native, Capacitor ve Cordova'da artık sonuç döndürür (void → bool).

Düzeltildi

  • Python, Go, Java, .NET, Ruby ve Rust SDK'larında şirketler, AI ajanları, SQL, özel ajanlar, veri boru hattı ve ilgi etiketleri işlemleri eksikti (56 işlem).
  • Android SDK: java.time kullanımı kaldırıldı; Android 6–7'de olay ve teslim alındısı gönderimi çökebiliyordu.

Eklendi (Faz 67a–67b)

  • Android teslimat güçlendirme: Android SDK üretici/ROM ve arka plan kısıtlarını teşhis eder, Pushizo.Delivery ile kullanıcıyı doğru ayar ekranına yönlendirir; teslim alındısı arka planda da gönderilir. Yeni rapor GET /v1/apps/{app}/analytics/android-delivery ve panelde Analitik → Android (ADR-0092).
  • Site içi AI arama (Growth+): sitenizin içeriğini dizine alan arama, isteğe bağlı kaynak gösteren AI yanıtı, Web SDK Pushizo.Search ve hazır arama penceresi (/v1/apps/{app}/site-search, POST /sdk/v1/apps/{app}/search, ADR-0093).

Eklendi (Faz 65–66)

  • Şirket/hesap nesneleri (B2B, her planda): şirketler, kişi ↔ şirket rolleri, company.* segment koşulu ve {{ company.* }} şablon değişkenleri (/v1/apps/{app}/companies, ADR-0090).
  • Ambar segmenti (Growth+): BigQuery, Snowflake veya Databricks'te sorgu çalıştırıp yalnız kişi kimliklerini çeken, zamanlanmış yenilenen segment; maliyet tavanı ve şifreli bağlantılar (/v1/apps/{app}/warehouse-segments, ADR-0091).

Eklendi (Faz 61–64)

  • Telegram ve Viber kanalları (Starter+): bot belirteciyle kanal, derin bağlantıyla abonelik bağlama (/v1/apps/{app}/messenger-links), metin/görsel/düğme mesajları, teslim/okundu, gelen kutusu ve AI ajanı (ADR-0086).
  • SQL editörü ve SQL segment (Growth+): izinli görünümlerde salt okunur sorgu, sonucu zamanlanmış yenilenen segment olarak kaydetme (/v1/apps/{app}/sql/*, ADR-0087).
  • Veri boru hattı (Growth+): gelen olay ve kişi verisine kural ve JavaScript dönüştürmeleri, karantina, webhook ve HTTP pull kaynakları (/v1/apps/{app}/data-pipelines, ADR-0088).
  • Yayın öncesi denetim (her planda): marka, yasaklı ifade, bağlantı, kişiselleştirme ve KVKK/İYS kontrolleri; kritik bulguda gönderim açık onay ister (POST /v1/apps/{app}/campaigns/{id}/preflight, preflight_ack). Özel AI ajanları (Growth+): yalnız taslak üreten zamanlanmış ajanlar (/v1/apps/{app}/custom-agents, ADR-0089).

Eklendi (Faz 60)

  • Konuşmalı AI ajanı (Growth+): WhatsApp, SMS, RCS ve canlı sohbette SSS ve webhook araçlarıyla (sipariş durumu, randevu) müşteriye otomatik yanıt, temsilciye devir kuralları, aylık token tavanı, çalışma kaydı ve ölçüm. /v1/apps/{app}/ai-agents, panelde Gelen kutusu → AI ajanı (ADR-0085).

Değişti

  • API hata mesajları varsayılan olarak İngilizce; Accept-Language: tr gönderen istemciler Türkçe alır. Hata kodları (error.code) değişmedi; entegrasyonlar kodla karar vermeye devam etmeli. Panel kendi dil tercihini kullanır. Yanıtlar Content-Language başlığı taşır.
  • MCP sunucusu (@pushizo/mcp-server): araç ve parametre açıklamaları, sunucu talimatı ve ipuçları İngilizce; araç adları ve şemalar aynı.

Eklendi

  • Geliştirici dokümantasyonu İngilizce: tüm sayfalar ve API başvurusu /en/docs/... altında; dil seçici, hreflang, iki dilli site haritası ve /en/llms.txt.
  • Kurulum sihirbazı: platform seçimine Amazon Fire OS (ADM), Windows (WNS), E-posta ve SMS eklendi; platformlar Mobil / Web ve masaüstü / Mesajlaşma olarak gruplandı. Mobil çerçevelere Expo ve Kotlin Multiplatform eklendi, "Yerel" seçeneği Swift, Objective-C, Kotlin ve Java'yı kapsar; her seçenekte açıklama, yayın bekleyenlerde "Yakında" rozeti. Kimlik bilgisi adımında Amazon (Client ID + Secret) ve Windows (Package SID + Secret) doğrulamalı formları, e-posta/SMS için kanal durumu kartı; SDK adımında Windows C# kayıt kodu, Kotlin Multiplatform rehberi ve yerel Android'de Huawei/Amazon ek modül satırları. Yeni belge docs/sdk/windows.md.

Düzeltildi

  • Push tıklama oranı hep %0 görünüyordu: bildirime (gövdeye) dokunma yalnız açılma sayılıyor, tıklama yalnız aksiyon düğmesinde yazılıyordu. Artık push'ta her dokunma tıklamadır (clicked_at, counts.clicked, delivery.clicked webhook'u, message.clicked segmenti). SDK değişikliği gerekmez; eski veriler geriye dönük değişmez.

Eklendi

  • Web sayfası kişiselleştirme (Growth+, Faz 59): sitedeki öğeleri (CSS seçici) kişiye göre değiştiren deneyimler — metin, görsel, bağlantı, gizle/göster; sayfa koşulları, ziyaretçi/cihaz/segment hedefleme, A/B (kontrol grubu), dönüşüm hedefi (SDK olayı, sayfa, tıklama) ve günlük rapor. /v1/apps/{app}/web-personalizations, Web SDK uygulayıcı (titreme önleme, webPersonalization: false ile kapatılır), panelde görsel seçicili düzenleyici, Node SDK webPersonalizations (ADR-0083). Web SDK ana paket bütçesi 40→42 KB.
  • İçerik kartları (Faz 58b): kampanya istatistiğinde kart gösterim/tıklama/kapatma oranları (cards) ve panelde kart kartı; React Native, Flutter, Capacitor, Cordova, Unity, .NET MAUI, KMP mobil ve Web SDK'da ContentCards; Android HsContentCardsView ve iOS HSContentCardsView hazır kart görünümleri (ADR-0082 eki).
  • İçerik kartları: mesaj içeriğinde content_card (klasik, görsel + metin, yalnız görsel; sabitleme, öncelik, düğme metni); SDK kart akışı GET /sdk/v1/apps/{app}/users/{user}/cards ve gösterim/tıklama/kapatma olayları; Android ve iOS Pushizo.ContentCards (ADR-0082). Kartlar bildirim kutusu listesinde görünmez.
  • İlgi etiketleri (Growth+): olay özelliklerinden (kategori, marka) zamanla sönen ilgi skoru; /v1/apps/{app}/affinity/*, segment koşulu affinity.<özellik>, şablonda {{ affinity.<özellik> }}, panelde İlgi Etiketleri sayfası.
  • Uygulama kaldırma raporu: GET /v1/apps/{app}/analytics/uninstalls (günlük seri, iOS/Android, oran, kaldırmadan önceki son mesaj, CSV). Mobil push'ta "cihaz kayıtlı değil" yanıtı aboneliği uninstall nedeniyle kapatır.
  • Sunucuda işlemsel sentetik izleme: infra/scripts/synthetic.sh 15 dakikada bir uçtan uca bildirim akışını sınar, sonucu Prometheus metriği olarak yazar; PushizoSyntheticFailing ve PushizoSyntheticStale alarmları. infra/scripts/latency-report.sh gecikme teşhis raporu.
  • HS_PLAN_FEATURE_REQUIRED hata ayrıntısında required_plan (özelliği açan en düşük plan); plan mevcut plan olarak kalır.
  • MCP sunucusu 0.2.0: 19 yeni okuma aracı (RFM, öngörü modelleri, özellik bayrakları, yol analizi, rapor oluşturucu, karar ajanları, katalog ve öneriler, kanal skoru, bölgeler, Wallet şablonları); toplam 73 araç. Yazma araçları yalnızca mcp:write veya admin kapsamlı anahtara listelenir; hız sınırı ve zaman aşımı hataları yeniden deneme ipucuyla döner.
  • Katalog okuma uçları (GET /v1/apps/{app}/catalogs…) analytics:read kapsamıyla da açılır; yazma admin ister.

Düzeltildi

  • Reklam API varsayılan sürümleri desteklenen sürümlere çekildi: Meta v26.0, Google Ads v26, LinkedIn 202610 (öncekiler kullanımdan kalkmıştı). Google kampanya tarihleri startDateTime/endDateTime, Meta lookalike ülkesiz, Google Customer Match üyelik süresi 540 gün, lookalike tohumu liste kimliği (ADR-0041 eki). Gerçek hesapla doğrulama bekliyor.
  • PHP SDK: Faz 33–48 kaynakları eklendi (şema kapsamı 361/361).
  • Python SDK içe aktarılamıyordu (üretilen Wallet pass metodu ayrılmış sözcük); üretici Python ayrılmış sözcüklerini korur. Wallet ve öneri metotları tüm sunucu SDK'larında Node adlarıyla aynı (wallet.getPass, listPasses, recommendations.updateConfig…).
  • SDK sürümleri 0.2.0 (web, çerçeveler, Node, CLI, Python, Ruby, Rust, PHP, Go, Java, .NET; Android 0.2.1); @pushizo/web eş bağımlılığı ^0.2.0.
  • iOS SDK 0.2.0: Objective-C cephesi (@import Pushizo;, PZ önekli sınıflar) ve Pushizo.xcframework (iOS, simülatör, Mac Catalyst; SPM binary target). Mac Catalyst derlemesi düzeltildi. KMP mobil paketi iOS hedefleri (iosArm64, iosSimulatorArm64, iosX64).
  • Köprü SDK'lar 0.2.0 (Flutter, React Native, Capacitor, Cordova, Unity, MAUI): özellik bayrakları, gömülü yerleşimler ve arka plan bölge izleme; yerel pushizo-android 0.2.1 ve Pushizo iOS 0.2.0'a bağlı. KMP mobil: gelen kutusu, tercihler, bayraklar, bölge izleme. KMP sunucu istemcisi: JSON kaçışı, zaman aşımı, yeniden deneme. Panel SDK sihirbazında Rust.

Güvenlik

  • Konum sorgu parametreleri (lat, lng) ve entegrasyon kimlik bilgisi alanları API loglarında maskelenir; nginx erişim logunda Wallet kart bağlantısı ve cihaz kimliği maskelenir (ADR-0076).
  • MCP: kimlik ve yol parçalarında . ve .. reddedilir; kimlik alanları desenle sınırlandı.
  • Destek oturumunda entegrasyon, depo aktarımı ve reverse-ETL kimlik bilgisi yazan uçlar kapalıdır.

Değişti

  • RFM segmentasyonu, ürün öneri motoru, öngörü modelleri, karar ajanları, otonom kampanya ajanı, rapor oluşturucu ve yol analizi Growth ve üstü planlarda (ADR-0078). Free ve Starter'da bu uçlar 403 HS_PLAN_FEATURE_REQUIRED döner; mevcut veri silinmez, zamanlanmış hesaplar durur.
  • Wallet kart güncelleme ve iptali panelde campaigns.send izni ister (composer rolü kart verir, güncelleyemez). Public API kapsamları değişmedi.
  • brand-kit/extract, rapor çalıştırma ve yol analizi uçlarına uca özel hız sınırı.
  • /healthz ve OpenAPI sürümü 1.1.0; MCP serverInfo.version paket sürümüyle aynı.
  • Kırıcı değişiklik tabanı (api/openapi.baseline.yaml) 1.1.0 sözleşmesine çekildi.

1.1.0 - 2026-11-04

Eklendi

  • Karar motoru: kişi başına en iyi seçeneği öğrenen ajanlar, otomasyonda Akıllı karar adımı, kontrol grubuna karşı kazanç raporu, panel sayfası ve API (migration 0100, ADR-0074).
  • Öngörü modelleri: kayıp riski ve olay olasılığı, kalite ölçümü, prediction.<ad> kitle alanı, panel sayfası ve API (migration 0099, ADR-0073).
  • Apple ve Google Wallet: kupon, sadakat kartı ve bilet; imzalı .pkpass, Google kaydet bağlantısı, kart güncelleme, mesajda wallet_pass etiketi, panel sayfası ve API (migration 0098, ADR-0072).
  • Rapor oluşturucu: kaynak, metrik, kırılım ve filtre seçerek özel rapor; grafik, CSV, kaydetme, panel sayfası ve API (migration 0097, ADR-0071).
  • Kullanıcı yolları: bir olaydan sonra veya önce izlenen yollar; Analitik sekmesi, Sankey grafik, CSV ve API (ADR-0070).
  • En iyi kanal: kullanıcı başına kanal skoru, best_channel kitle alanı ve otomasyonda Kanal seçimi adımı; panel sayfası ve API (migration 0096, ADR-0069).
  • Gömülü yerleşimler: uygulamanın ayırdığı alana içerik, Web render, Android ve iOS veri API'si (migration 0095, ADR-0068).
  • Özellik bayrakları: yüzdeli ve zamanlanmış kademeli yayın, segment hedefi, uzaktan yapılandırma değerleri; panel, API, Web, Android ve iOS SDK (migration 0093, ADR-0066).
  • Arka plan bölge izleme: isteğe bağlı, varsayılan kapalı; Android ve iOS SDK işletim sistemiyle izler, sunucuya koordinat gönderilmez (ADR-0065).
  • Bölgeler (geofence): uygulama açıkken gönderilen konumdan giriş ve çıkış olayları, otomasyon tetiği, panel sayfası ve API (migration 0092, ADR-0064).
  • Ürün önerileri: yedi strateji, günlük hesap, şablonda {% recommendations %}, e-posta tasarımcısında öneri bloğu ve API (migration 0091, ADR-0063).
  • Ürün kataloğu: CSV ve API ile ürün yükleme, şablon etiketleri ve e-posta tasarımcısında ürün bloğu (migration 0089).

Düzeltildi

  • Sertleştirme: Wallet açık uç sınırları, log maskesi, destek oturumu kapsamı, rapor sorgusu süre sınırı, katalog sınırı, saklama işleri.
  • API anahtarları: oluşturma penceresi taşmıyor, liste dar ekranda kart görünümüne geçiyor.

Değişti

  • "Journey" adı panelde, sitede ve belgelerde "Otomasyon / Automation" oldu. API yolları, alanlar ve webhook olayları (journeys, journey_id, journey.*) aynı kaldı.

Eklendi

  • Panel asistanı adımlı otomasyon taslağı üretir ve açık otomasyonun taslağını düzenler. Yayın ve gönderim yapmaz; webhook, segment, şablon ve A/B adımları değişmez (ADR-0057).
  • Android SDK 0.2.1: login(externalId, HsUserProfile) ve Firebase Installation ID kipi desteği.
  • Kotlin Multiplatform SDK'sı (sdk/kmp-mobile): ortak API ve Android hedefi; iOS hedefi Objective-C köprüsüyle birlikte gelecek.
  • Admin paneli genişletmesi II (ADR-0054, migration 0080–0081): org başına kota/özellik geçersiz kılma, liste tarih filtreleri, e-posta değişiminde doğrulama seçimi, tek tık yazma destek oturumu; panelden yönetilen site içeriği (fiyat tablosu, duyuru bandı, yasal metin sürümleri; anonim GET /public/v1/site/*, tanıtım sitesi ISR ile okur); genel bakışta MRR/ARR, ödeme geçmişi ve aşım tahmini; sistem sağlığında yedek tazeliği ve Alertmanager alarmları (PROMETHEUS_URL, ALERTMANAGER_URL); gruplu admin menüsü ve ⌘K arama.
  • Ek kanallar (ADR-0052, migration 0077): push yedek kanalı, saat hedefi, Amazon ADM, Windows WNS, Android canlı güncelleme, iOS carousel, VoIP, App Clip, profil zaman çizelgesi, oturum raporu, SMS gönderici kaydı ve ayrılmış IP. CLI, Kotlin Multiplatform, FlutterFlow, Rust ve AMP web push yardımcıları public API'yi çağırır. Postman koleksiyonu depodadır; postman.com çalışma alanı hesap ister.
  • App rolü, ani e-posta hacmi, Google Postmaster ve SMS doğrulama (ADR-0053, migration 0078). Kod yanıtta dönmez. AI kurulum istemleri docs/ai-prompts altındadır. Node SDK reverse-etl uçlarını da içerir.

Değişti

  • Public API içe aktarma türü legacy_players (POST /v1/apps/{appId}/imports). Eski tür adı kaldırıldı; kırıcı sözleşme değişikliğidir, sürüm etiketiyle yayımlanır.
  • MCP yazma uçları eklendi (/v1 mcp/template-drafts, journey-drafts, in-app-drafts, test-sends). Gönderim yapmaz; mevcut sürüme ektir.
  • AppsFlyer, Adjust ve RevenueCat gelen webhook (ADR-0047, migration 0072).
  • Java sunucu SDK paket ve Maven koordinatı com.pushizo (com.pushizo:pushizo-java); paket henüz yayınlanmadığı için kırıcı değil.

1.0.0 - 2026-10-16

Öne çıkanlar

  • Pushizo marka adı: ürün HeroSignal'den Pushizo'ya taşındı; paketler @pushizo/*, imajlar ghcr.io/exec0de/pushizo-*, SDK paket adları ve varsayılan API kökü https://api.pushizo.com, hata dokümantasyonu https://docs.pushizo.com/errors.
  • v2 fazları (15–21): kurumsal kimlik (SAML/OIDC SSO, SCIM, JWT kimlik doğrulama), ölçek mimarisi (ClickHouse, Kafka, Go dispatcher, Helm), iOS Live Activities, Huawei HMS, konum; sürükle-bırak e-posta editörü, HTML in-app, şablon galerisi, Data Feeds, Dynamic Content, AI içerik asistanı; WhatsApp, RCS, iki yönlü SMS, teslim edilebilirlik; Event Streams, veri ambarı dışa aktarımı, hazır entegrasyonlar ve MCP sunucusu; veri yerleşimi (EU/TR), white-label ve bayi.
  • eski sağlayıcı tarzı kurulum akışı: "Başlarken" ve SDK kurulum sayfaları (platform seçimi, adım adım kurulum, kod örneklerinde genel API adresi).

Eklendi

  • Kurumsal kimlik (Faz 15): SAML 2.0 ve OIDC SSO (alan adı DNS doğrulaması, JIT, IdP grup → rol, test girişi, "yalnızca SSO" ve sahip kurtarma kodları), SCIM 2.0 (/scim/v2/Users, /Groups), org'lar arası app taşıma (iki sahip + platform admin onayı), olay başına saklama süresi, SIEM denetim akışı (audit.created webhook'u ve günlük NDJSON).
  • JWT identity verification: app başına ES256 genel anahtarları (/v1/apps/:appId/identity-keys), identity_verification_mode (hmac \| jwt \| both); Web/Android/iOS/Flutter/RN/Capacitor/Cordova/MAUI/Unity SDK'larında login(externalId, { jwt }) ve updateUserJwt; Node/PHP/Python/Go/Java/.NET/Ruby sunucu SDK'larında belirteç üretme yardımcısı.
  • iOS Live Activities (Faz 17a): tür kaydı ve şema doğrulaması, POST /v1/apps/:appId/live-activities/:activityType/start\|update\|end, SDK push-to-start/güncelleme belirteci uçları (sahiplik kanıtı zorunlu), APNs liveactivity yükü, journey live_activity düğümü (Liquid + şema çevirisi), dashboard Live Activities sayfası, iOS SDK Pushizo.LiveActivities.register ve köprülerde genel tür.
  • Huawei HMS, Flutter web, Mac Catalyst, konum (Faz 17b, ADR-0025): hms_push kanalı ve Push Kit sağlayıcısı (OAuth, data mesajı, doğrulama), Android pushizo-hms modülü, Flutter web (Web SDK köprüsü), iOS Mac Catalyst; tüm SDK'larda Location.setShared/isShared/requestPermission (yalnızca ön plan, KVKK rıza kaydı, kapatınca silme), segmentte "yarıçap içinde" koşulu, dashboard Huawei kanal kartı ve kullanıcı konumu.

Güvenlik

  • Yol kanonikleştirme ve rota desenine göre kimlik türü (API anahtarı yalnızca /v1, oturum yalnızca /internal//admin); /internal ve /admin mutasyonlarında köken + içerik türü denetimi; HTML yanıtlarına CSP.
  • TRUST_PROXY ile sınırlı vekil güveni (XFF sahteciliğiyle IP izin listesi/hız sınırı atlatılamaz); IPv6 CIDR izin listesi.
  • API anahtarı kapsamı rol iznine bağlandı; app kapsamlı üyeler için org geneli işlem ve okuma sınırları.
  • SDK sahiplik kanıtı e-posta/SMS yeniden kaydına, olaylara, in-app/inbox ve tercih uçlarına genişletildi (ADR-0016 K7–K9).
  • Resend imza zorunluluğu (üretim), SNS TopicArn/tazelik; hook token'larının log maskelemesi; MinIO en az yetkili servis kullanıcısı; API Explorer SRI.

Eklendi

  • Başarısız kuyruk işleri (DLQ) listesi ve yeniden deneme (admin), kanal durumu ucu, olay tanımlarında imleç sayfalama, kampanya onayında kota önizlemesi, segment/şablon arama.
  • Journey'ler (Faz 11, ADR-0018): 13 düğüm türlü motor (bekleme, koşul, split, zaman penceresi, gönderim A/B, webhook, tag), giriş/çıkış kuralları, hedefler, takvim, sürümleme, çökme sonrası kurtarma; React Flow builder, run zaman çizelgesi, journey.* webhook'ları; gönderim düğümünde tercih kategorisi.
  • A/B ve tercihler (Faz 12, ADR-0019): kampanya/journey/in-app A/B (deterministik atama, holdout, z-testi, otomatik/elle kazanan; in-app kazanan 0024), kategoriler ve kullanıcı tercihleri (API, tüm istemci SDK'ları dahil RN/Capacitor/Cordova/MAUI/Unity, barındırılan tercih merkezi), etiketler, şablon analitiği, çoklu frekans pencereleri, outcome türleri (unique/unattributed), usage_duration segmenti, retention kohortu, SMS HELP/STOP yanıtları.
  • Operasyon (Faz 14): Docker/compose/Helm, CI/CD (release, SDK yayını, E2E, Stripe test modu, gitleaks, Dependabot, PR imaj derleme), Prometheus/Grafana/Alertmanager, Sentry, sentetik izleme, kaos tatbikatı, wal-g + günlük temel yedek, runbook'lar, docs-site (+ dağıtım), eski sağlayıcı göç aracı, Postman koleksiyonu, GO_LIVE_CHECKLIST.md.

Güvenlik

  • Üretim Postgres'te uygulama rolü NOSUPERUSER/NOBYPASSRLS (RLS gerçekten uygulanır); API/worker açılışta rolü denetler.

0.6.0 — 2026-10-07 (Faz 10: e-posta, SMS, in-app, bildirim kutusu)

Eklendi

  • SMS: Twilio ve Netgsm (encoding: TR, İYS filtresi); kısa link (/t/s), GSM-7/UCS-2/Türkçe kaydırma segment sayımı (smsSegments), STOP/START (Twilio gelen mesaj, Netgsm gelen kutusu sorgusu, genel webhook).
  • Gelen geri bildirim: /hooks/email/{ses\|resend\|smtp\|mock}/{token}, /hooks/sms/{twilio\|mock}/{token} (SNS/Svix/Twilio imzaları); bounce/complaint/teslim/açılma/tıklama teslimata, sayaçlara ve webhook'lara işlenir; Netgsm rapor sorgusu.
  • Suppression list: özet + maskeli değer; audience ve gönderim anında kontrol; internal + public API, dashboard ekranı.
  • In-app mesajlar: blok tabanlı modal/banner/tam ekran, tetikler (oturum, olay, ekran, trigger), segment kitlesi, sıklık, istatistik; Web/Android/iOS/Flutter render ve InAppMessages API'si; dashboard editörü ve canlı önizleme.
  • Bildirim kutusu: add_to_inbox mesajları; SDK Inbox (liste, okundu, tümü, arşiv) ve uçları; kullanıcı detayında inbox.
  • SDK: User.addEmail/removeEmail/addSms/removeSms (anonim kullanıcıya user.subscription_id ile bağlama); Node hs.suppressions, PHP Suppressions; örnek uygulamalar güncellendi.
  • Dashboard: E-posta/SMS kanal ayarları ve webhook adresi kartı, kampanya/şablon editöründe E-posta ve SMS sekmeleri (MJML editörü + sandbox önizleme, segment sayacı).

Değişti

  • ci:local OpenAPI denetimi birleşim (oneOf/anyOf) varyantlarını ayırt eder: yeni varyant kırıcı sayılmaz, mevcut varyanta zorunlu alan eklemek sayılır.

0.5.0 — 2026-10-07 (Faz 9: webhook'lar)

Eklendi

  • Giden webhook'lar: endpoint yönetimi (internal + public admin), 20 olay türü, HMAC-SHA256 imza (Pushizo-Signature), 24 saatlik secret rotasyonu, özel başlıklar (şifreli), batch modu (delivery.* 100'erli), test gönderimi, teslim geçmişi, tekil/toplu replay.
  • Teslim motoru: transactional outbox + worker taraması (ADR-0014), üstel yeniden deneme (1 dk → 24 sa, 7 istek sonra dead), SSRF koruması (https, özel IP/yerel ad reddi, DNS sonrası IP sabitleme, yönlendirme yok), endpoint sağlığı (7 gün failing + e-posta, 14 gün disabled), 30 gün saklama, webhook_deliveries_total metriği.
  • SDK: Node verifyWebhookSignature / constructWebhookEvents / hs.webhooks; PHP Pushizo\Webhook.
  • Dashboard: Webhooks liste ve detay ekranları, imza doğrulama örnekleri; trace'te webhook teslimleri.
  • Migration 0014_webhooks (up/down); docs/webhooks.md; E2E webhooks.spec.ts.

Düzeltildi (Faz 9 eksik turu)

  • Kullanıcı silme ve app veri temizliği webhook teslim geçmişindeki kişisel veriyi de siler (KVKK/GDPR).
  • Webhook taraması: endpoint başına kota ve eşzamanlılık sınırı, devre kesici, kira korumalı gönderim (çok worker'da çift gönderim önlenir).
  • event.received aboneliğinde olay adı filtresi zorunlu; başarısız test gönderimi endpoint sağlığını etkilemez; alias/external_id değişiminde user.updated; alias ekleme çakışması transaction'ı bozmaz; 64 KB üzeri yük kesilir.
  • Bildirim merkezinde sorunlu webhook'lar; gecikme metrikleri ve tests/load/webhooks-bench.mjs (p95 4,5 sn).

0.4.0 — 2026-10-07 (Faz 0–8 derin denetim ve eksik kapatma)

Eklendi

  • API: Idempotency-Key başlığı, filter[...] ve sort parametreleri, export/import cursor sayfalaması, bildirim geçmişi (GET /v1/notifications/{id}/history), ?kind= filtresi, X-HTTP-Method-Override, SDK alias ve dismissed uçları, SDK hata raporları, kanal kimlik bilgisi dosya yükleme, statik segmentler (segments/{id}/refresh), bildirim merkezi, kullanıcı son mesajları, kampanya canlı akışı (SSE), genel bakışta özel tarih aralığı ve son kampanyalar, web push istem/SW ayarları SDK config'te, public organizasyon/üye/audit uçları.
  • Teslimat: FCM data-only ve ortak hs {dlv, msg, url, buttons} payload alanı, 4 KB payload sınırı, cihaz bazında APNs ortamı, iOS rozet artırma, app başına adil sıralama ve sağlayıcı hız sınırı, rate_limited için deneme sayılmayan erteleme, kimlik bilgisi reddinde sahibine e-posta, mock:open, test cihazı adları.
  • SDK'lar: Android 12+ uyumlu bildirim açma, token değişiminde güncelleme, alias API'si (Web/Android/iOS/Flutter), Flutter ön plan engelleme, iOS NSE rozet/kategori birleştirme, web slidedown kaydırma tetikleyicisi ve kategoriler, SW yeniden deneme, SDK hata raporlama, Node SDK notifications.history.
  • Dashboard: ⌘K komut paleti, bildirim zili, global app seçici; request_id'li hata durumları; DataTable/CodeBlock/DateRangePicker/JsonViewer/Stepper; yerel sayı biçimi ve hesap saat dilimi; API anahtarı süresi; gönderim onay modalı; kişiselleştirme değişken seçici; web izin istemi tasarımcısı; kullanıcı detayı düzenleme; SDK hataları log sekmesi.
  • Araçlar: npm run ci:local (OpenAPI kırıcı değişiklik, npm audit, gizli bilgi taraması, i18n, migration çiftleri), npm run openapi:baseline, k6 olay ingest betiği.

Değişti

  • Kiracı dışı erişim her zaman 404 HS_NOT_FOUND (ADR-0011); geçersiz cursor 400 HS_VALIDATION_ERROR.

Güvenlik

  • fastify 5.11.3 → 5.12.5 (yüksek önem, 7 GHSA), js-yaml 5.3.0 → 5.4.3 (overrides); TOTP tekrar kullanım engeli, API anahtarı iptal önbelleği yarışı, artan giriş gecikmesi, JSON derinlik ve gövde boyutu sınırları, aktif DEK önbelleğinin rotasyonu algılaması.

0.3.0 — 2026-10-07 (Faz 8: olaylar, analitik, dönüşüm, export/import)

Eklendi

  • Analitik API ve ekranları: teslimat (gün/kanal/kampanya), abonelik büyümesi, olay hacmi, dönüşüm/gelir, funnel, sağlayıcı sağlığı (hata kodları, gecikme p50/p95), etkileşim ısı haritası; tarih aralığı, önceki dönemle karşılaştırma, CSV export; ECharts grafikleri.

Performans

  • 1M olay ingest tek API sürecinde 11679 olay/sn (hedef ≥ 5k); 100.000 kullanıcı export 2,0 sn (18,1 MB CSV, hedef < 60 sn); 1M olay ingest sırasında worker olay işlemesi eşzamanlı çalıştı.

0.2.0 — 2026-10-07 (Faz 7: segmentler, şablonlar, kampanyalar)

Eklendi

  • Segmentler: iç içe all/any/none koşul AST'si → parametrik SQL derleyici (tag/özellik/dil/cihaz/semver/olay sayısı/mesaj etkileşimi/segment üyeliği), canlı önizleme ve önbellekli tahmin uçları, dashboard segment builder.
  • Şablonlar: sürümlü mesaj şablonları (template_versions), geri alma, Liquid render önizlemesi; POST /v1/notifications içinde template_id.
  • Kampanyalar: durum makinesi (taslak/zamanlandı/çalışıyor/duraklatıldı/tamamlandı/iptal/başarısız), planlı ve tekrarlı (cron + saat dilimi) gönderim, kullanıcı saat dilimi ve akıllı teslimat, hız sınırı, frekans/sessiz saat istisnaları, onay akışı (settings.campaignApprovalRequired), kopyalama, istatistik/rollup uçları; dashboard 5 adımlı kampanya oluşturucu ve detay ekranı.
  • Hedefleme: included_segments, excluded_segments, filters, all ve delayed_option artık Public API'de çalışır (Faz 4 501 yanıtları kaldırıldı).
  • Tamamlama turu: Teslimat politikaları ekranı (sessiz saat, frekans sınırı, varsayılan TTL); segmentin kullanıldığı kampanyalar; kampanya listesinde tür/kanal filtresi ve iptal; kampanya detayında abone bazlı teslimat tablosu ve "başarısızlara yeniden gönder"; ad yazarak iptal onayı; Kullanıcılar sayfasında segment builder filtresi ve POST /v1/apps/{app_id}/users/search; hedef kitle snapshot'ı (segment_snapshot); TABLESAMPLE ile büyük tablo tahmini; builder between/subscription.status; içerik editöründe kanal sekmeleri; Chrome önizleme çerçevesi.

0.1.0 — 2026-10-06 (MVP: Faz 0–6)

Eklendi

  • Altyapı (Faz 0): npm workspaces + Turborepo monorepo; NestJS 11 + Fastify API; BullMQ worker; Next.js 16 dashboard; Drizzle + SQL migration'lar (up/down); pino + Prometheus metrikleri; OpenAPI üretimi ve tip güvenli istemci.
  • Kimlik ve kiracılık (Faz 1): kayıt/giriş/e-posta doğrulama/parola sıfırlama, oturum yönetimi, TOTP MFA + kurtarma kodları, giriş kilidi; organizasyon/üyelik/davet, roller ve app kapsamı, API anahtarları (scope, iptal ≤ 60 sn önbellek), audit log, Redis hız sınırı, Postgres RLS ikinci savunma hattı, org MFA zorunluluğu ve IP izin listesi.
  • Son kullanıcı kimliği (Faz 2): end user / alias / abonelik modeli, anonim → kimlikli birleştirme, tag/özellik merge-patch, identity verification (HMAC), SDK API (/sdk/v1), public Users/Subscriptions API, KVKK/GDPR silme ve veri dışa aktarma.
  • Sağlayıcılar (Faz 3): envelope encryption (DEK + MASTER_KEY, rotasyon komutları), APNs HTTP/2, FCM HTTP v1, Web Push (VAPID), mock sağlayıcı, kanal doğrulama uçları.
  • Teslimat motoru (Faz 4): POST /v1/notifications (idempotency), audience/dispatch worker'ları, LiquidJS kişiselleştirme, bastırma (frekans sınırı, sessiz saat), planlı yeniden deneme, sayaçlar, trace ekranı, test cihazları, kuyruk-veritabanı uzlaştırma işi.
  • SDK'lar (Faz 5): Web (@pushizo/web), Android, iOS (+ Notification Service Extension), Flutter, Node, PHP; örnek uygulamalar ve docs/sdk/* rehberleri.
  • Dashboard çekirdeği (Faz 6): onboarding stepper (simülasyon modu, canlı cihaz algılama, test push), Genel Bakış KPI'ları, SDK Kurulumu, Test Cihazları, API Explorer, Loglar; tr/en, koyu tema, axe erişilebilirlik taraması.

Güvenlik

  • Güvenlik başlıkları (CSP, HSTS, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, X-Frame-Options) API ve dashboard'da.
  • Gizli bilgiler (p8, servis hesabı, VAPID private, SDK secret) yalnızca şifreli saklanır; API'den geri okunamaz.

On this page