![[V9.1.0 julio de 2018]](ng910.gif)
Mensajería utilizando REST API
Puede utilizar messaging REST API para realizar mensajería simple punto a punto y de publicación. Puede publicar mensajes en un tema, enviar mensajes a una cola, examinar mensajes en una cola, y obtener de forma destructiva mensajes de una cola. La información se envía a messaging REST API y se recibe de ella en formato de texto plano.
Antes de empezar
Nota:
- El messaging REST API está habilitado de forma predeterminada. Puede inhabilitar messaging REST API para evitar toda la mensajería. Para obtener más información sobre cómo habilitar o inhabilitar messaging REST API, consulte Configuración de messaging REST API.
- messaging REST API está integrado con la seguridad de IBM® MQ . Para utilizar messaging REST API, los usuarios deben estar autenticados en el servidor mqweb y deben ser miembros del rol MQWebUser . El usuario también debe estar autorizado para acceder a la colao tema que se haya especificado. Para más información sobre la seguridad de REST API, consulte IBM MQ Consola y REST API seguridad.
- Si utiliza Advanced Message Security (AMS) con messaging REST API, tenga en cuenta que todos los mensajes se cifran utilizando el contexto del servidor mqweb, no el contexto del usuario que publica el mensaje.
- Al recibir o consultar un mensaje, sólo se admiten los mensajes con formato IBM MQ
MQSTR. Posteriormente, todos los mensajes se reciben de forma destructiva bajo el punto de sincronización y los mensajes no manejados se dejan en la cola. La cola IBM MQ puede configurarse para mover estos mensajes envenenados a un destino alternativo. Para más información, consulte Manejo de mensajes envenenados en IBM MQ clases para JMS. - messaging REST API no le proporciona una entrega única de mensajes con soporte transaccional. Si se emite un HTTP POST y la conexión falla antes de que el cliente reciba una respuesta HTTP, el cliente no puede indicar inmediatamente si el mensaje se ha enviado a la cola especificada, o si se ha publicado en el tema especificado. Si se emite un HTTP DELETE y la conexión falla antes de que el cliente reciba una respuesta HTTP, se podría haber obtenido un mensaje de forma destructiva y perderse, ya que no hay ninguna forma de recuperarse de la destrucción.
- Las nuevas líneas de las cadenas entrantes se eliminan en la operación POST de HTTP. Aplicaciones REST
no debe utilizar nuevas líneas en los mensajes que se envían o publican utilizando la API REST, ya que se perderán.