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
Die folgenden Endpunkte sind bei Pfaden relativ zur Basis-URL verfügbar.
Veröffentliche eine Nachricht
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
Die Identifikator des Erlebnisses, an das du deine Nachrichten senden möchtest.Du kannst die Universitäts-ID deiner Erfahrung auf Creator-Dashboard kopieren.
Das Thema, auf das du deine Nachricht veröffentlichen möchtest, mit bis zu 80 Zeichen.
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.
- 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
Der Inhalt der Nachricht, die du auf den Live-Server veröffentlichen möchtest.