Compartilhar via

Enviar uma notificação nativa do Serviço de Notificação por Push do Windows (WNS)

Envia uma notificação nativa do WNS por meio de um hub de notificação.

Solicitação

Método URI da solicitação Versão HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

Cabeçalhos da solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação Descrição
Autorização Token SAS gerado conforme especificado na Autenticação de Assinatura de Acesso Compartilhado com o Barramento de Serviço.
Tipo de conteúdo Definir 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 Definida como windows
X-WNS- Todos os cabeçalhos que começam com X-WNS serão encaminhados para o WNS.

Corpo da solicitação

O corpo da solicitação é um documento XML , conforme especificado pelo WNS. Se a notificação for do tipo "wns/raw", o corpo será qualquer texto de 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 status HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código Descrição
200 Mensagem enviada com êxito.
400 A solicitação está malformada (por exemplo, cabeçalhos de roteamento não válidos, tipo de conteúdo não válido, mensagem excede o tamanho, formato de mensagem inválido).
401 Falha de autorização. A chave de acesso estava incorreta.
403 Cota excedida ou mensagem muito grande; mensagem foi rejeitada.
404 Nenhum branch de mensagem no URI.
413 Entidade solicitada muito grande. O tamanho da mensagem não pode ter mais de 64 Kb.

Para obter informações sobre status códigos, consulte Códigos de status e erro.

Cabeçalhos de resposta

Cabeçalho de resposta Descrição
Location Esse cabeçalho só está disponível para Hubs de Notificação da camada Standard.

Esse cabeçalho conterá a ID da Mensagem de Notificação. Ele é usado com telemetria por mensagem e correlação de Comentários PNS. O cabeçalho de localização usa 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