Doğrudan gönderme

  • Makale

Doğrudan bir cihaz tanıtıcısına ( Bildirim türü tarafından ifade edilen geçerli bir belirteç) bildirim gönderir. Bu API'nin kullanıcılarının kayıtları veya yüklemeleri kullanması gerekmez. Bunun yerine, tüm cihazları kendi başlarına yönetirsiniz ve Azure Notification Hubs'ı yalnızca bir geçiş hizmeti olarak kullanarak çeşitli Anında İletilen Bildirim Hizmetleri ile iletişim kurarsınız.

Önemli

Firebase Cloud Messaging (FCM), geliştiricilerin Google Play destekli Android cihazlara anında iletme bildirimleri göndermesini kolaylaştıran bir hizmettir. Azure Notification Hubs şu anda eski HTTP protokollerini kullanarak FCM ile iletişim kurar. FCM v1, daha fazla özellik ve özellik sunan güncelleştirilmiş bir API'dir. Google, FCM eski HTTP'sini kullanımdan kaldırdıklarını ve 20 Haziran 2024'te desteklemeyi durduracaklarını duyurdu. Bu nedenle, bugün Google Play tarafından desteklenen Android cihazlarıyla iletişim kurmak için Azure Notification Hubs kullanan geliştiricilerin uygulamalarını ve bildirim yüklerini daha yeni bir biçime geçirmeleri gerekir. Azure Notification Hubs, Google istekleri kabul etmemeye devam edene kadar FCM'nin eski HTTP'sini desteklemeye devam edecektir. Yeni FCM tümleştirmesi tamamlandıktan sonra Azure Notification Hubs, geçişe ne zaman başlayabileceğinizi duyurur. Diğer ayrıntılar için bu makaledeki geçiş adımlarına bakın.

İstek

Yöntem İstek URI'si HTTP Sürümü
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 HTTP/1.1

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek üst bilgisi Açıklama
Yetkilendirme Service Bus ile Paylaşılan Erişim İmzası Kimlik Doğrulaması'nda belirtildiği gibi oluşturulan SAS belirteci.
İçerik Türü İçerik Türü üst bilgisini hedef platform bildirim hizmetini temel alarak ayarlayın:
  • WNS: application/json olarak ayarlayın; charset=utf-8 veya application/xml. Bildirim türü (X-WNS-Type) "wns/raw" ise application/octet-stream olarak ayarlayın.
  • GCM ve APNS: application/json olarak ayarlanır; charset=utf-8.
  • MPNS: application/xml;charset=utf-8 olarak ayarlayın.
ServiceBusNotification-DeviceHandle PNS cihaz tanıtıcısı.
ServiceBusNotification-Tags {tek etiket tanımlayıcısı} (isteğe bağlı)
ServiceBusNotification-Format Şu geçerli PlatformType değerlerinden birine ayarlayın: windows, apple, gcm, , windowsphone, adm, nokiaxbaidu
x-ms-version 2015-04 (2015-01 ve üzeri tarafından desteklenir)

İstek gövdesi

Platform türüne bağlı olarak istek gövdesi biçimleri değişir. Yerel SEND REST API'lerindeki her bir platform için gövde biçimlerine bakın.

Yanıt

Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi içerir. Yanıt gövdesi başarılı olduğunda döndürülür.

Yanıt kodları

Kod Description
201 İleti başarıyla gönderildi.
400 İstek yanlış biçimlendirilmiş (örneğin, geçerli yönlendirme üst bilgileri değil, geçerli içerik türü değil, ileti boyutu aşıyor, hatalı ileti biçimi).
401 Yetkilendirme hatası. Erişim anahtarı yanlıştı.
403 Kota aşıldı veya ileti çok büyük; iletisi reddedildi.
404 URI'de ileti dalı yok.
413 İstenen varlık çok büyük. İleti boyutu 64 Kb'tan büyük olamaz.

Durum kodları hakkında bilgi için bkz. Durum ve Hata Kodları.

Yanıt üst bilgileri

HTTP 1.1 kullanırken sertifika tabanlı kimlik doğrulaması kullanılırken PNS geri bildirimi çalışmaz; herhangi bir veri döndürmez. Belirteç tabanlı kimlik doğrulamayı kullanın.

Yanıt üst bilgisi Description
İçerik Türü application/xml; charset=utf-8
Konum Bu üst bilgi yalnızca Standart katman Notification Hubs için kullanılabilir.

Bu üst bilgi bildirim iletisi kimliğini içerir. İleti başına telemetri ile kullanılır: Bildirim İletisi Telemetrisi Alma ve PNS geri bildirimini ilişkilendirme. Konum üst bilgisi aşağıdaki biçimi kullanır:

https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04.

Yanıt gövdesi

Yok.

Sonraki adımlar