Compartilhar via

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

  • Artigo

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

Solicitação

Método URI da solicitação Versão de 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 Defina como application/json;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (opcional)
ServiceBusNotification-Format Defina como apple.
ServiceBusNotification-Apns-Expiry Expiração de apns no W3C DTF, YYYY-MM-DDThh:mmTZD (por exemplo, 1997-07-16T19:20+01:00).

Corpo da solicitação

O corpo da solicitação é 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 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: obter telemetria de mensagem de notificação e correlacionar 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

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