Compartir a través de

Envío de una notificación nativa del Servicio de notificaciones push de Windows (WNS)

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

Solicitud

Método URI de solicitud Versión de 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 Se establece en application/json;charset=utf-8 o application/xml. Si el tipo de notificación (X-WNS-Type) es wns/raw, establezca en application/octet-stream.
ServiceBusNotification-Tags {single tag identifier} (opcional)
ServiceBusNotification-Format Establézcala en windows
X-WNS- Todos los encabezados que empiecen por X-WNS se reenviarán a WNS.

Cuerpo de la solicitud

El cuerpo de la solicitud es un documento XML especificado por WNS. Si la notificación es de tipo "wns/raw", el cuerpo es cualquier texto de hasta 5 Kb. Por ejemplo:

<?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>

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 ser superior a 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 la telemetría por mensaje y la correlación de 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

  • Last updated on