Share via

Skicka direkt

  • Artikel

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:
  • WNS: Ange till application/json; charset=utf-8 eller application/xml. Om meddelandetypen (X-WNS-Type) är "wns/raw" anger du till application/octet-stream.
  • GCM och APNS: Ange till application/json; charset=utf-8.
  • MPNS: Ange till application/xml;charset=utf-8.
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, , windowsphonegcm, adm, , nokiaxbaidu
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.

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.

Nästa steg