Servicio de mensajería
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Esta página contiene la documentación de referencia para el APIde mensajería Open Cloud v1, que puede difundir mensajes en todos los servidores de tu experiencia.
La API v2 tiene su propia versión del método Publicar mensaje.Para obtener información sobre el uso del método v2, consulte el Guía de uso de mensajes.
CrossServerMessaging
Los siguientes extremos están disponibles en rutas relativas a la URL base.
Publicar un mensaje
Publica un mensaje a un tema predefinido de una experiencia, con el tamaño del mensaje de hasta 1,024 caracteres (1 KB).Requiere el permiso Publicar para las claves de API y el alcance universal-mensajería-servicio:publicar para las aplicaciones de OAuth 2.0.Vea mensajería entre servidores para definir y suscribir usuarios a un tema.
Parámetros
El identificador de la experiencia en la que quieres enviar tus mensajes.Puedes copiar la ID del universo de tu experiencia en Panel del creador .
El tema al que desea publicar su mensaje, con hasta 80 caracteres.
Respuesta
Permisos obligatorios
Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta Gestionar claves API.
- Claves API: 5000 requests per minute across all API keys for a user or group
- OAuth2: 5000 requests per minute per app user
Note: Rate limits can be lower during high-traffic periods. Certain endpoints have additional rate limits. Learn more about rate limits.
Objetos
Los siguientes objetos describen cargas que son aceptadas o devueltas. Ve cada extremo para más información sobre cuándo se utilizan estos objetos.
PublishRequest
El objeto cuerpo de solicitud con la cadena de mensajes que quieres publicar en el servidor en vivo.
Atributos
El contenido del mensaje que quieres publicar en el servidor en vivo.