Windows (WNS)
Microsoft Store ile ilişkilendirilmiş Windows uygulamalarına WNS bildirimi — paket gerekmez, kanal adresi SDK kayıt uç noktasına yazılır.
Microsoft Store ile ilişkilendirilmiş (MSIX paketli) Windows uygulamaları, Windows Push Notification Services (WNS)
üzerinden wns_push kanalıyla bildirim alır. Ayrı bir Pushizo paketi yoktur: uygulama Windows SDK'nın kanal API'siyle
kanal adresini alır ve SDK kayıt uç noktasına yazar. Sunucu tarafı (gönderim, kimlik doğrulama, adres denetimi)
ADR-0052'dedir.
1. Partner Center ve Visual Studio
- Partner Center → uygulamanız → Ürün kimliği (Product identity): Package SID (
ms-app://s-1-15-2-…). - Partner Center → uygulamanız → WNS/MPNS: Client secret.
- Visual Studio → proje → Publish → Associate App with the Store. Package SID bu ilişkilendirmeyle uygulamaya bağlanır.
2. Panel
Kanallar → Windows Bildirim Hizmeti (ya da kurulum sihirbazında Windows (WNS) kartı): Package SID ve Client Secret'ı girin. Kayıt sırasında WNS OAuth uç noktasına karşı doğrulanır; sır sunucuda şifreli saklanır, geri gösterilmez.
3. Uygulama kodu (C#)
Panelde Başlarken → SDK kodu → Windows (WNS) App ID'niz ve API adresiniz yerleştirilmiş hâlini verir.
using System.Net.Http.Json;
using System.Text.Json;
using System.Text.Json.Serialization;
using Windows.Networking.PushNotifications;
public static class PushizoWindows
{
private static readonly HttpClient Http = new();
private static readonly JsonSerializerOptions Json = new() { DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull };
// Her açılışta çağırın: kanal adresi zamanla değişir, aynı adres ikinci abonelik oluşturmaz.
public static async Task RegisterAsync(string? externalId = null)
{
var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
var timezone = TimeZoneInfo.TryConvertWindowsIdToIanaId(TimeZoneInfo.Local.Id, out var iana) ? iana : null;
var body = new
{
channel = "wns_push",
token = channel.Uri,
device = new { os = "Windows", os_version = Environment.OSVersion.Version.ToString(), sdk_platform = "windows", locale = System.Globalization.CultureInfo.CurrentUICulture.Name, timezone },
user = externalId is null ? null : new { external_id = externalId },
};
var response = await Http.PostAsJsonAsync("https://api.pushizo.com/sdk/v1/apps/<APP_ID>/subscriptions", body, Json);
response.EnsureSuccessStatusCode();
}
}- Kayıt
POST /sdk/v1/apps/{appId}/subscriptions(channel: "wns_push",token= kanal adresi) idempotenttir. - Gönderimde yalnızca
https://*.notify.windows.comadreslerine istek yapılır; başka adresli abonelik geçersiz token olarak işaretlenir ve kapatılır. - Bildirim
wns/toast(ToastGeneric: başlık + metin) olarak gider; bildirimin adresi varsa toastlaunchdeğerine yazılır. - Kullanıcıyı kendi kimliğinizle eşlemek için
externalIdverin (user.external_id). - WNS'nin süresi dolmuş/geçersiz kanal yanıtında abonelik sunucuda kapatılır.
Sınırlar
- Dokunma/açılma ölçümü yoktur (toast'ta teslimat kimliği taşınmaz); teslim ve hata durumları raporlanır.
- In-app mesaj, bildirim kutusu ve konum özellikleri Windows'ta yoktur. .NET MAUI SDK'sının Windows hedefinde bu çağrılar etkisizdir; MAUI ile Windows'a bildirim için bu sayfadaki kayıt kodu kullanılır.