Messaging-Dienst

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

Sie können Anfragen und Antworten an folgende Anmelde- und Antwort-Server senden und empfangen, um Mitteilungen über die Verbreitung von Nachrichten auf Servern Ihres Erlebnisses zu senden. Weitere Informationen zum Gebrauch der API finden Sie unter Messaging-Benutzerhandbuch.

CrossServerMessaging

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

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

Veröffentlichen Sie eine Nachricht

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

Veröffentlichen Sie eine Nachricht an ein vordefiniertes Thema eines Erlebnisses, mit der Größe der Nachricht bis zu 1,024 Zeichen (1 KB). Benötigt die Publish-Berechtigung für API-Schlüssel und das Universum-Messaging-Service:publish-Zugriffsberechtigung für OAuth 2.0-Apps. Siehe Cross-Server-Messaging für die Definition und das

Parameter

universeId number

Die Identifikator der Erfahrung, an die du deine Nachrichten senden möchtest. Du kannst die Universe ID deiner Erlebnisauf dem Creator-Dashboard kopieren.

Path
Erforderlich
topic string

Das Thema, an 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

Um diesen Endpunkt nutzen zu können, werden folgende Anwendungsbereiche für deine OAuth 2.0 App benötigt. Weitere Informationen zur Registrierung einer OAuth 2.0-App findest du unter App Registration and Review.

  • universe-messaging-service:publish

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 Request-Body-Objekt mit der Nachrichten-String, die Sie auf den Live-Server veröffentlichen möchten.

Attribute

message string

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