Partilhar via

Enviar uma notificação nativa do Apple Platform Notification Services (APNS)

  • Artigo

Envia uma notificação nativa de APNS 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 Definido como application/json;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (opcional)
ServiceBusNotification-Format Definido como apple.
ServiceBusNotification-Apns-Expiry Os apns expiram no W3C DTF, YYYY-MM-DDThh:mmTZD (por exemplo, 1997-07-16T19:20+01:00).

Corpo do pedido

O corpo do pedido é um documento XML , conforme especificado pela Apple. Por exemplo:

    { 
        "aps" : { 
            "alert" : " This is my toast message for iOS!", 
        }, 
    }

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 a Telemetria por Mensagem: Obter Telemetria de Mensagens de Notificação e correlacionar 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

Enviar em lote direto
Enviar uma notificação nativa do APNS
Enviar uma notificação nativa do MPNS
Enviar uma notificação nativa do WNSEnviar uma notificação de modelo