Sunucu tarafı hızlı başlangıç
API anahtarı oluşturun, ilk POST /v1/notifications isteğini cURL ile gönderin, sonra sunucu SDK'larından birini (Node, PHP, Python, Go, Java, .NET, Ruby) kullanın.
Sunucu tarafı tüm işlemler https://api.pushizo.com/v1 altındaki REST API ile yapılır; sunucu SDK'ları aynı API'yi kaynak × metot olarak sarar. API anahtarı istemciye (tarayıcı, mobil uygulama) gömülmez.
API anahtarı oluşturun
Dashboard → Organizasyon → API anahtarları → Yeni anahtar: ad, app (ya da org geneli), kapsamlar (notifications:write ile başlayın), isteğe bağlı IP izin listesi ve bitiş tarihi. Ham anahtar (hs_live_…) yalnızca bir kez gösterilir; environment: test anahtarları hs_test_ öneki alır ve staging entegrasyonlarını ayırır. Kapsamlar ve rotasyon: API anahtarları.
İlk istek (cURL)
curl -X POST "https://api.pushizo.com/v1/notifications" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ilk-bildirim-1" \
-d '{
"app_id": "app_…",
"target": { "test_devices_only": true },
"headings": { "tr": "Merhaba", "en": "Hello" },
"contents": { "tr": "Pushizo çalışıyor", "en": "Pushizo is working" },
"url": "https://example.com"
}'
# 202 → { "id": "msg_…", "status": "queued", "recipients_estimate": 1, "external_id_missing": [] }Durum: GET /v1/notifications/{message_id}?app_id=app_…; teslimatlar: GET /v1/notifications/{message_id}/deliveries. Yanıt 202 asenkron teslimat demektir; sonuçlar sayaçlara ve webhook'lara düşer.
SDK seçin
import { Pushizo } from '@pushizo/node';
const hs = new Pushizo({ apiKey: process.env.PUSHIZO_API_KEY!, appId: 'app_…' });
const res = await hs.notifications.create({
idempotency_key: 'order-1001',
target: { include_aliases: { external_id: ['user_42'] } },
contents: { tr: 'Siparişiniz kargoya verildi', en: 'Your order shipped' },
});Tüm SDK'lar 429/5xx için üstel geri çekilmeyle yeniden dener, idempotency anahtarını otomatik üretir ve cursor sayfalamayı paginate / list_all / ListAll yardımcılarıyla dolaşır. Rehberler: SDK'lar.
Webhook alın
Dashboard → Geliştirici → Webhooks ile delivery.*, subscription.*, user.* olaylarını HTTPS uç noktanıza alın; Pushizo-Signature başlığını doğrulayın (Webhook'lar).
Sonraki adımlar: Bildirim gönderme, Kullanıcı ve abonelik yönetimi, API referansı.
React Native, Capacitor, Cordova, MAUI ve Unity
Yerel Android/iOS SDK'larını saran köprü SDK'ları için ortak kurulum sırası ve platforma özgü rehberler.
Faturalama, planlar ve kota (Faz 13)
Plan matrisi, deneme, Stripe/iyzico/mock sağlayıcıları, kullanım raporu, kota ve özellik kapıları, uyarı e-postaları. Tasarım kararları: ADR-0020. Ortak kod: packages/billing (plan matrisi, sağlayıcı adaptörleri, kota…