Service de messagerie

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Cette page contient une documentation de référence pour le service de messagerie Open Cloud v1, qui peut diffuser des messages sur tous les serveurs de votre expérience.

L'API v2 a sa propre version de la méthode Publier le message.Pour obtenir des informations sur l'utilisation de la méthode v2, voir le guide d'utilisation des messages.

CrossServerMessaging

https://apis.roblox.com/messaging-service/

Les points de terminaison suivants sont disponibles à des chemins relatifs à l'URL de base.

Publier un message

POST /v1/universes/{universeId}/topics/{topic}

Publiez un message sur un sujet prédéfini d'une expérience, avec la taille du message jusqu'à 1 024 caractères (1 Mo).Nécessite l'autorisation publier pour les clés API et le domaine messagerie universelle : publier pour les applications OAuth 2.0.Voir messagerie entre serveurs pour définir et s'abonner aux utilisateurs à un sujet.

Paramètres

universeId number

L'identifiant de l'expérience dans laquelle vous souhaitez envoyer vos messages.Vous pouvez copier l'ID de l'univers de votre expérience sur tableau de bord du créateur .

Path
Requis
topic string

Le sujet auquel vous voulez publier votre message, avec jusqu'à 80 caractères.

Path
Requis

Réponse

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Publier

Objets

Les objets suivants décrivent les charges utiles qui sont acceptées ou renvoyées. Voir chaque point de terminaison individuel pour plus d'informations sur l'utilisation de ces objets.

PublishRequest

L'objet du corps de la demande avec la chaîne de message que vous voulez publier sur le serveur en direct.

Attributs

message string

Le contenu du message que vous souhaitez publier sur le serveur en direct.