Enviar uma notificação nativa do Windows Push Notification Service (WNS)
Envia uma notificação nativa WNS através de um 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 | Defina como application/json;charset=utf-8 ou application/xml. Se o tipo de notificação (X-WNS-Type) for wns/raw, defina como application/octet-stream. |
| ServiceBusNotification-Tags |
{single tag identifier} (opcional) |
| ServiceBusNotification-Format | Definir como windows |
| X-WNS- | Todos os cabeçalhos que começam com X-WNS serão reencaminhados para o WNS. |
Corpo do pedido
O corpo do pedido é um documento XML , conforme especificado pelo WNS. Se a notificação for do tipo "wns/raw", o corpo é qualquer texto até 5 Kb. Por exemplo:
<?xml version="1.0" encoding="utf-8" ?>
<toast>
<visual lang="en-US">
<binding template="ToastText01">
<text id="1">
This is my toast message for Win8!
</text>
</binding>
</visual>
</toast>
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 é mal formado (por exemplo, cabeçalhos de encaminhamento não válidos, não é válido tipo de conteúdo, 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 telemetria por mensagem e correlaciona 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.