Layanan Pesan

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Anda dapat mengirim dan menerima permintaan dan jawaban berikut untuk menyiarkan pesan ke seluruh server pengalaman Anda. Untuk informasi tentang penggunaan API, lihat Panduan Penggunaan Messaging.

CrossServerMessaging

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

Endpoint berikut tersedia di jalur relatif terhadap base URL.

Publikasikan Pesan

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

Publish a message to a pre-defined topik pengalaman, dengan ukuran pesan hingga 1,024 karakter (1 KB). Memerlukan izin Publish untuk API keys dan scope universe-messaging-service:publish untuk OAuth 2.0 apps. Lihat Cross-Server Messaging untuk mendefinisikan dan subscribe pengguna ke topik.

Parameter

universeId number

Pengenal pengalaman di mana Anda ingin mengirim pesan Anda. Anda dapat menyalin ID Universe pengalaman Anda di Creator Dashboard.

Path
Diperlukan
topic string

Topik yang ingin Anda publikasikan pesan Anda, dengan hingga 80 karakter.

Path
Diperlukan

Respons

Izin yang Diperlukan

Izin kunci API berikut diperlukan untuk memanggil endpoint ini. Untuk mengetahui informasi selengkapnya tentang cara membuat kunci yang tepat, lihat Cara Mengelola Kunci API.

  • Publikasi

Cakupan berikut diperlukan agar aplikasi OAuth 2.0 dapat menggunakan endpoint ini. Untuk mengetahui informasi selengkapnya tentang cara mendaftarkan aplikasi OAuth 2.0, lihat Pendaftaran dan review aplikasi.

  • universe-messaging-service:publish

Objek

Objek berikut mendeskripsikan muatan yang diterima atau diberikan. Lihat masing-masing endpoint untuk mengetahui informasi selengkapnya tentang waktu penggunaan objek ini.

PublishRequest

Objek tulang permintaan dengan string pesan yang ingin Anda publikasikan ke server live.

Atribut

message string

Konten pesan yang ingin Anda publikasikan ke server live.