Kirim langsung

Mengirim pemberitahuan langsung ke handel perangkat (token yang valid seperti yang dinyatakan oleh jenis Pemberitahuan ). Pengguna API ini tidak perlu menggunakan pendaftaran atau penginstalan. Sebagai gantinya, Anda mengelola semua perangkat sendiri dan menggunakan Azure Notification Hubs hanya sebagai layanan pass-through untuk berkomunikasi dengan berbagai Layanan Pemberitahuan Push.

Penting

Firebase Cloud Messaging (FCM) adalah layanan yang, antara lain, memfasilitasi pengembang mengirim pemberitahuan push ke perangkat Android yang didukung Google Play. Azure Notification Hubs saat ini berkomunikasi dengan FCM menggunakan protokol HTTP warisan. FCM v1 adalah API terbaru yang menawarkan lebih banyak fitur dan kemampuan. Google mengumumkan bahwa mereka menghentikan HTTP warisan FCM dan akan berhenti mendukungnya pada 20 Juni 2024. Oleh karena itu, pengembang yang menggunakan Azure Notification Hubs untuk berkomunikasi dengan perangkat Android yang didukung Google Play hari ini, harus memigrasikan aplikasi dan payload pemberitahuan mereka ke format yang lebih baru. Azure Notification Hubs akan terus mendukung HTTP warisan FCM hingga Google berhenti menerima permintaan. Setelah integrasi FCM baru selesai, Azure Notification Hubs akan mengumumkan kapan Anda dapat mulai bermigrasi. Untuk detail selengkapnya, lihat langkah-langkah migrasi di artikel ini.

Minta

Metode Meminta URI Versi HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 HTTP/1.1

Header permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Meminta kop Deskripsi
Authorization Token SAS yang dihasilkan seperti yang ditentukan dalam Autentikasi Tanda Tangan Akses Bersama dengan Azure Service Bus.
Jenis-Konten Atur header Jenis Konten berdasarkan layanan pemberitahuan platform target:
  • WNS: Atur ke aplikasi/json; charset=utf-8 atau application/xml. Jika jenis pemberitahuan (X-WNS-Type) adalah "wns/raw", atur ke application/octet-stream.
  • GCM dan APNS: Atur ke aplikasi/json; charset=utf-8.
  • MPNS: Atur ke application/xml;charset=utf-8.
ServiceBusNotification-DeviceHandle Handel perangkat PNS.
ServiceBusNotification-Tags {pengidentifikasi tag tunggal} (opsional)
ServiceBusNotification-Format Atur ke salah satu nilai PlatformType yang valid berikut: windows, , apple, gcm, windowsphoneadm, , nokiax,baidu
x-ms-version 2015-04 (Didukung oleh 2015-01 dan yang lebih baru)

Isi permintaan

Berdasarkan jenis platform, format isi permintaan berubah. Lihat format isi untuk setiap platform individual di KIRIM REST API asli.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons. Isi respons dikembalikan pada keberhasilan.

Kode respons

Kode Deskripsi
201 Pesan berhasil dikirim.
400 Permintaan cacat (misalnya, header perutean yang tidak valid, bukan tipe konten yang valid, pesan melebihi ukuran, format pesan yang buruk).
401 Kegagalan otorisasi. Kunci akses salah.
403 Kuota terlampaui atau pesan terlalu besar; pesan ditolak.
404 Tidak ada cabang pesan di URI.
413 Entitas yang diminta terlalu besar. Ukuran pesan tidak boleh lebih dari 64 Kb.

Untuk informasi tentang kode status, lihat Status dan Kode Kesalahan.

Header respons

Saat menggunakan HTTP 1.1, umpan balik PNS tidak berfungsi saat menggunakan autentikasi berbasis sertifikat; tidak mengembalikan data apa pun. Gunakan autentikasi berbasis token.

Header respons Deskripsi
Jenis-Konten application/xml; charset=utf-8
Lokasi Header ini hanya tersedia untuk Notification Hubs tingkat Standar.

Header ini berisi ID pesan pemberitahuan. Ini digunakan dengan telemetri per pesan: Dapatkan Telemetri Pesan Pemberitahuan dan menghubungkan umpan balik PNS. Header lokasi menggunakan format berikut:

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

Isi Respons

Tidak ada.

Langkah berikutnya

  • Last updated on