메시징 서비스

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

경험의 서버 간에 방송 메시지를 전송하고 받을 수 있습니다. 대시보드 메시지 전송 가이드를 참조하십시오. API 사용 가이드 에 대한 정보는 보시오.

CrossServerMessaging

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

다음 끝점은 기준 URL과 관련된 경로에서 사용할 수 있습니다.

메시지 게시

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

경험의 미리 정의된 주제에 메시지 게시, 크기가 메시지 1,024자(1KB)까지 올 수 있습니다. 게시 권한이 API 키에 대한 게시 권한 및 universe-messaging-service:publish 범위에 대한 OAuth 2.0 앱의 범위를

매개 변수

universeId number

메시지를 보내려는 경험의 식별자. 크리에이터 대시보드에서 경험의 유니버스 ID를 복사합니다.

Path
필수
topic string

최대 80자까지 메시지를 게시할 주제입니다.

Path
필수

응답

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 게시

OAuth 2.0 애플리케이션에서 이 엔드포인트를 사용하려면 다음 범위가 필요합니다. OAuth 2.0 애플리케이션 등록 방법에 대한 자세한 내용은 앱 등록 및 심사에서 확인하세요.

  • universe-messaging-service:publish

개체

다음 개체는 수락되거나 반환되는 페이로드를 설명합니다. 이러한 개체가 사용되는 시기에 대한 자세한 정보는 각 개별 끝점을 참고하세요.

PublishRequest

라이브 서버에 게시하기를 원하는 메시지 문자열이 있는 요청 본문 개체입니다.

특성

message string

라이브 서버에 게시하려는 메시지 콘텐츠입니다.