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.

Consulte também

  • Last updated on