Compartir a través de


Envío de una notificación nativa de Apple Platform Notification Services (APNS)

Envía una notificación nativa de APNS mediante un centro de notificaciones.

Solicitud

Método URI de solicitud Versión HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Authorization Token de SAS generado tal y como se especifica en Autenticación de firma de acceso compartido con Service Bus.
Content-Type Establézcalo en application/json;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (opcional)
ServiceBusNotification-Format Establézcalo en apple.
ServiceBusNotification-Apns-Expiry Expiración de Apns en W3C DTF, AAAA-MM-DDThh:mmTZD (por ejemplo, 1997-07-16T19:20+01:00).

Cuerpo de la solicitud

El cuerpo de la solicitud es un documento XML especificado por Apple. Por ejemplo:

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

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Códigos de respuesta

Código Descripción
200 Mensaje enviado correctamente.
400 La solicitud es incorrecta (por ejemplo, encabezados de enrutamiento no válidos, tipo de contenido no válido, el mensaje supera el tamaño, formato de mensaje incorrecto).
401 Error de autorización. La clave de acceso era incorrecta.
403 Cuota superada o mensaje demasiado grande; mensaje rechazado.
404 No hay ramificación de mensaje en el URI.
413 Entidad solicitada demasiado grande. El tamaño del mensaje no puede tener más de 64 Kb.

Para obtener información sobre los códigos de estado, vea Códigos de estado y error.

Encabezados de respuesta

Encabezado de respuesta Descripción
Location Este encabezado solo está disponible para Notification Hubs de nivel Estándar.

Este encabezado contendrá el identificador del mensaje de notificación. Se usa con telemetría por mensaje: obtener telemetría de mensajes de notificación y correlacionar los comentarios de PNS. El encabezado de ubicación usa el siguiente formato:

https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04

Response body

Ninguno.

Consulte también

Envío directo por lotes
Envío de una notificación nativa de APNS
Envío de una notificación nativa de MPNS
Enviar una notificación nativa de WNS Enviaruna notificación de plantilla