Partilhar via

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