Share via


Inviare una notifica modello

Invia una notifica a una registrazione modello in un hub di notifica.

Richiesta

Metodo URI richiesta Versione HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

Intestazioni della richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta Descrizione
Autorizzazione Token di firma di accesso condiviso generato come specificato in Autenticazione della firma di accesso condiviso con il bus di servizio.
Content-Type Impostare su application/json;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (facoltativo)
ServiceBusNotification-Format Impostare su template (facoltativo)

Testo della richiesta

Il corpo della richiesta è un oggetto JSON, con solo proprietà stringa. Ad esempio:

{
    "message": "My message!",
    "otherPropety": "my other value"
}

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Codice Descrizione
200 Messaggio inviato correttamente.
400 La richiesta non è valida( ad esempio, intestazioni di routing non valide, tipo di contenuto non valido, dimensioni del messaggio superiori a un formato di messaggio non valido).
401 Errore di autorizzazione. La chiave di accesso non è corretta.
403 Quota superata o messaggio troppo grande; messaggio rifiutato.
404 Nessun ramo di messaggio nell'URI.
413 Entità richiesta troppo grande. Le dimensioni del messaggio non possono essere superiori a 64 KB.

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni di risposta

Intestazione risposta Descrizione
Location Questa intestazione è disponibile solo per Hub di notifica di livello Standard.

Questa intestazione conterrà l'ID messaggio di notifica. Viene usato con i dati di telemetria per messaggioe correlando il feedback PNS. L'intestazione del percorso usa il formato seguente:

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

Corpo della risposta

No.

Vedere anche