Direct verzenden
Hiermee wordt een melding rechtstreeks naar een apparaat-ingang verzonden (een geldig token zoals uitgedrukt door het meldingstype ). Gebruikers van deze API hoeven geen registraties of installaties te gebruiken. In plaats daarvan beheert u alle apparaten zelf en gebruikt u Azure Notification Hubs uitsluitend als passthrough-service om te communiceren met de verschillende pushmeldingsservices.
Belangrijk
Firebase Cloud Messaging (FCM) is een service waarmee ontwikkelaars onder andere pushmeldingen kunnen verzenden naar Android-apparaten die door Google Play worden ondersteund. Azure Notification Hubs communiceert momenteel met FCM via het verouderde HTTP-protocol. FCM v1 is een bijgewerkte API die meer functies en mogelijkheden biedt. Google heeft aangekondigd dat het verouderde HTTP-bestand van FCM wordt afgeschaft en dat deze op 20 juni 2024 niet meer wordt ondersteund. Daarom moeten ontwikkelaars die momenteel Azure Notification Hubs gebruiken om te communiceren met Android-apparaten die door Google Play worden ondersteund, hun toepassingen en nettoladingen voor meldingen migreren naar de nieuwere indeling. Azure Notification Hubs blijft ondersteuning bieden voor verouderde HTTP van FCM totdat Google geen aanvragen meer accepteert. Zodra de nieuwe FCM-integratie is voltooid, meldt Azure Notification Hubs wanneer u kunt beginnen met migreren. Zie de migratiestappen in dit artikel voor meer informatie.
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 |
HTTP/1.1 |
Aanvraagheaders
In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.
| Aanvraagheader | Description |
|---|---|
| Autorisatie | SAS-token gegenereerd zoals opgegeven in Shared Access Signature Authentication met Service Bus. |
| Content-Type | Stel de Content-Type-header in op basis van de meldingsservice van het doelplatform:
|
| ServiceBusNotification-DeviceHandle | De PNS-apparaatingang. |
| ServiceBusNotification-Tags | {single tag identifier} (optioneel) |
| ServiceBusNotification-Format | Stel in op een van de volgende geldige PlatformType-waarden: windows, apple, , gcm, windowsphone, adm, nokiaxbaidu |
| x-ms-version | 2015-04 (ondersteund door 2015-01 en hoger) |
Aanvraagbody
Op basis van het platformtype wordt de indeling van de aanvraagbody gewijzigd. Raadpleeg de hoofdtekstindelingen voor elk afzonderlijk platform in systeemeigen Send REST API's.
- Een systeemeigen APNS-melding verzenden
- Een systeemeigen FCM-melding verzenden
- Een systeemeigen GCM-melding verzenden
- Een systeemeigen MPNS-melding verzenden
- Een systeemeigen WNS-melding verzenden
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders. De antwoordtekst wordt geretourneerd bij succes.
Antwoordcodes
| Code | Description |
|---|---|
| 201 | Het bericht is verzonden. |
| 400 | De aanvraag is onjuist ingedeeld (bijvoorbeeld ongeldige routeringsheaders, ongeldig inhoudstype, bericht overschrijdt de grootte, ongeldige berichtindeling). |
| 401 | Autorisatiefout. De toegangssleutel is onjuist. |
| 403 | Quotum overschreden of bericht is te groot; het bericht is geweigerd. |
| 404 | Geen berichtbranch op de URI. |
| 413 | Aangevraagde entiteit is te groot. De berichtgrootte mag niet groter zijn dan 64 kB. |
Zie Status- en foutcodes voor meer informatie over statuscodes.
Antwoordheaders
Wanneer u HTTP 1.1 gebruikt, werkt PNS-feedback niet bij het gebruik van verificatie op basis van certificaten; er worden geen gegevens geretourneerd. Gebruik verificatie op basis van tokens.
| Antwoordheader | Description |
|---|---|
| Content-Type | application/xml; charset=utf-8 |
| Locatie | Deze header is alleen beschikbaar voor Notification Hubs van de Standard-laag. Deze koptekst bevat de id van het meldingsbericht. Deze wordt gebruikt met telemetrie per bericht: Telemetrie van meldingsberichten ophalen en PNS-feedback correleren. De locatieheader heeft de volgende indeling: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04. |
Hoofdtekst van de reactie
Geen.