Enviar uma notificação de modelo
Envia uma notificação para um registo de modelo num hub de notificação.
Pedir
Método | URI do pedido | Versão HTTP |
---|---|---|
POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 |
HTTP/1.1 |
Cabeçalhos do pedido
A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.
Cabeçalho do pedido | Descrição |
---|---|
Autorização | Token de SAS gerado conforme especificado em Autenticação de Assinatura de Acesso Partilhado com o Service Bus. |
Content-Type | Definido como application/json;charset=utf-8 . |
ServiceBusNotification-Tags |
{single tag identifier} (opcional) |
ServiceBusNotification-Format | Definir como template (opcional) |
Corpo do pedido
O corpo do pedido é um objeto JSON, com apenas propriedades de cadeia. Por exemplo:
{
"message": "My message!",
"otherPropety": "my other value"
}
Resposta
A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.
Códigos de resposta
Código | Descrição |
---|---|
200 | Mensagem enviada com êxito. |
400 | O pedido tem um formato incorreto (por exemplo, cabeçalhos de encaminhamento não válidos, tipo de conteúdo não válido, a mensagem excede o tamanho, formato de mensagem incorreto). |
401 | Falha de autorização. A chave de acesso estava incorreta. |
403 | Quota excedida ou mensagem demasiado grande; a mensagem foi rejeitada. |
404 | Nenhum ramo de mensagem no URI. |
413 | Entidade pedida demasiado grande. O tamanho da mensagem não pode ter mais de 64 Kb. |
Para obter informações sobre códigos de estado, veja Códigos de Estado e erro.
Cabeçalhos de resposta
Cabeçalho de resposta | Descrição |
---|---|
Localização | Este cabeçalho só está disponível para Hubs de Notificação de escalão Standard. Este cabeçalho irá conter o ID da Mensagem de Notificação. É utilizado com a Telemetria Por Mensageme a correlação de Comentários PNS. O cabeçalho de localização utiliza o seguinte formato: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 |
Corpo da resposta
Nenhum.