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

Artigo
05/26/2023

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.

Compartilhar via