Compartir a través de

Envío directo

  • Artículo

Envía una notificación directamente a un identificador de dispositivo (un token válido expresado por el tipo de notificación ). Los usuarios de esta API no necesitan usar registros ni instalaciones. En su lugar, administra todos los dispositivos por sí mismos y usa Azure Notification Hubs únicamente como un servicio de paso a través para comunicarse con los distintos servicios de notificaciones push.

Importante

Firebase Cloud Messaging (FCM) es un servicio que, entre otras cosas, facilita a los desarrolladores el envío de notificaciones push a dispositivos Android compatibles con Google Play. Azure Notification Hubs se comunica actualmente con FCM mediante el protocolo HTTP heredado. FCM v1 es una API actualizada que ofrece más funciones y capacidades. Google anunció que está dejando de utilizar el protocolo HTTP heredado de FCM y que dejará de prestarle soporte el 20 de junio de 2024. Por lo tanto, los desarrolladores que utilicen Azure Notification Hubs para comunicarse con dispositivos Android compatibles con Google Play en la actualidad tendrán que migrar sus aplicaciones y cargas útiles de notificación al nuevo formato. Azure Notification Hubs seguirá siendo compatible con HTTP heredado de FCM hasta que Google deje de aceptar solicitudes. Una vez que se complete la nueva integración de FCM, Azure Notification Hubs anunciará cuándo se puede empezar a migrar. Para más información, consulte los pasos de migración en este artículo.

Solicitud

Método URI de solicitud Versión HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 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 Establezca el encabezado Content-Type basado en el servicio de notificación de la plataforma de destino:
  • WNS: 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.
  • GCM y APNS: se establece en application/json; charset=utf-8.
  • MPNS: se establece en application/xml;charset=utf-8.
ServiceBusNotification-DeviceHandle Identificador del dispositivo PNS.
ServiceBusNotification-Tags {identificador de etiqueta única} (opcional)
ServiceBusNotification-Format Establezca en uno de los siguientes valores válidos de PlatformType: windows, apple, gcmwindowsphone, adm, , nokiax.baidu
x-ms-version 2015-04 (compatible con 2015-01 y versiones posteriores)

Cuerpo de la solicitud

En función del tipo de plataforma, el cuerpo de la solicitud da formato a los cambios. Consulte los formatos de cuerpo de cada plataforma individual en las API REST de envío nativas.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta. El cuerpo de la respuesta se devuelve correctamente.

Códigos de respuesta

Código Descripción
201 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

Cuando se usa HTTP 1.1, los comentarios de PNS no funcionan al usar la autenticación basada en certificados; no devuelve ningún dato. Use la autenticación basada en tokens.

Encabezado de respuesta Descripción
Content-Type application/xml; charset=utf-8
Location Este encabezado solo está disponible para Notification Hubs de nivel Estándar.

Este encabezado contiene 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.

Pasos siguientes