Nachrichtendienst

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Diese Seite enthält Referenzdokumentation für den Open Cloud v1 Messaging-Service API, der Nachrichten auf allen Servern in deiner Erlebnisverbreiten kann.

Die v2-API hat ihre eigene Version der Publish Message-Methode.Für Informationen zur Verwendung der v2-Methode siehe den Messaging-Verwendungsleitfaden.

CrossServerMessaging

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

Die folgenden Endpunkte sind bei Pfaden relativ zur Basis-URL verfügbar.

Veröffentliche eine Nachricht

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

Veröffentliche eine Nachricht an ein vordefiniertes Thema eines Erlebnisses, mit einer Nachrichtengröße von bis zu 1.024 Zeichen (1 KB).Erfordert die Veröffentlichung -Berechtigung für API-Schlüssel und den Universum-Messaging-Service: publish -Bereich für OAuth 2.0-Apps.Siehe Cross-Server-Messaging, um Benutzer auf ein Thema zu definieren und zu abonnieren.

Parameter

universeId number

Die Identifikator des Erlebnisses, an das du deine Nachrichten senden möchtest.Du kannst die Universitäts-ID deiner Erfahrung auf Creator-Dashboard kopieren.

Path
Erforderlich
topic string

Das Thema, auf das du deine Nachricht veröffentlichen möchtest, mit bis zu 80 Zeichen.

Path
Erforderlich

Rückmeldung

Erforderliche Berechtigungen

Die folgenden API-Schlüssel-Berechtigungen werden benötigt, um diesen Endpunkt aufzurufen. Für weitere Informationen zur Erzeugung korrekter Schlüssel siehe API-Schlüssel verwalten.

  • Veröffentlichen

Limits
  • API-Schlüssel: 5000 Anfragen pro Minute über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe
  • OAuth 2.0: 5000 Anfragen pro Minute pro App-Benutzer

Hinweis: In Zeiten mit viel Datenverkehr können die Ratenbegrenzungen niedriger sein. Für bestimmte Endpunkte gelten zusätzliche Ratenbegrenzungen. Erfahre mehr über Ratenbegrenzungen.

Objekte

Die folgenden Objekte beschreiben Nutzlasten, die akzeptiert oder zurückgegeben werden. Die einzelnen Endpunkte zeigen weitere Informationen darüber an, wann diese Objekte verwendet werden.

PublishRequest

Das Anforderungskörper-Objekt mit der Nachrichtsschnur, die du auf den Live-Server veröffentlichen möchtest.

Attribute

message string

Der Inhalt der Nachricht, die du auf den Live-Server veröffentlichen möchtest.