Skicka direkt
Skickar ett meddelande direkt till ett enhetshandtag (en giltig token som uttrycks av meddelandetypen ). Användare av det här API:et behöver inte använda registreringar eller installationer. I stället hanterar du alla enheter på egen hand och använder Azure Notification Hubs enbart som en direkttjänst för att kommunicera med de olika push-meddelandetjänsterna.
Viktigt
Firebase Cloud Messaging (FCM) är en tjänst som bland annat underlättar för utvecklare att skicka push-meddelanden till Android-enheter som stöds av Google Play. Azure Notification Hubs kommunicerar för närvarande med FCM med hjälp av det äldre HTTP-protokollet. FCM v1 är ett uppdaterat API som erbjuder fler funktioner och funktioner. Google meddelade att de föråldrade FCM äldre HTTP och kommer att sluta stödja det den 20 juni 2024. Därför måste utvecklare som använder Azure Notification Hubs för att kommunicera med Android-enheter som stöds av Google Play i dag migrera sina program och aviseringsnyttolaster till det nyare formatet. Azure Notification Hubs fortsätter att stödja FCM-äldre HTTP tills Google slutar acceptera begäranden. När den nya FCM-integreringen är klar meddelar Azure Notification Hubs när du kan börja migrera. Mer information finns i migreringsstegen i den här artikeln.
Förfrågan
Metod | URI för förfrågan | HTTP-version |
---|---|---|
POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 |
HTTP/1.1 |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.
Begärandehuvud | Beskrivning |
---|---|
Auktorisering | SAS-token genereras enligt vad som anges i Signaturautentisering för delad åtkomst med Service Bus. |
Content-Type | Ange rubriken Innehållstyp baserat på målplattformens meddelandetjänst:
|
ServiceBusNotification-DeviceHandle | PNS-enhetshandtaget. |
ServiceBusNotification-Tags | {single tag identifier} (valfritt) |
ServiceBusNotification-Format | Ange till något av följande giltiga PlatformType-värden: windows , apple , , windowsphone gcm , adm , , nokiax baidu |
x-ms-version | 2015-04 (stöds av 2015-01 och senare) |
Begärandetext
Baserat på plattformstypen ändras formaten för begärandetexten. Se brödtextformaten för varje enskild plattform i interna Skicka REST-API:er.
- Skicka ett internt APNS-meddelande
- Skicka ett inbyggt FCM-meddelande
- Skicka ett internt GCM-meddelande
- Skicka ett ursprungligt MPNS-meddelande
- Skicka ett internt WNS-meddelande
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden. Svarstexten returneras när den lyckas.
Svarskoder
Kod | Description |
---|---|
201 | Meddelandet har skickats. |
400 | Begäran är felaktigt (till exempel ogiltiga routningshuvuden, ogiltig innehållstyp, meddelande överskrider storlek, felaktigt meddelandeformat). |
401 | Auktoriseringsfel. Åtkomstnyckeln var felaktig. |
403 | Kvoten har överskridits eller meddelandet är för stort. meddelandet avvisades. |
404 | Ingen meddelandegren vid URI:n. |
413 | Begärd entitet är för stor. Meddelandestorleken får inte vara över 64 kB. |
Information om statuskoder finns i Status och Felkoder.
Svarshuvuden
När du använder HTTP 1.1 fungerar inte PNS-feedback när du använder certifikatbaserad autentisering. den returnerar inga data. Använd tokenbaserad autentisering.
Svarsrubrik | Description |
---|---|
Content-Type | application/xml; charset=utf-8 |
Location | Det här huvudet är bara tillgängligt för Notification Hubs på standardnivå. Det här huvudet innehåller meddelande-ID:t. Den används med telemetri per meddelande: Hämta telemetri för meddelandemeddelanden och korrelera PNS-feedback. Platsrubriken använder följande format: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 . |
Själva svaret
Inga.