메시징 서비스

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

이 페이지에는 경험의 모든 서버에 메시지를 방송할 수 있는 Open Cloud v1 메시징 서비스 API에 대한 참조 문서가 포함되어 있습니다.

v2 API에는 자체 메시지 게시 메서드의 버전이 있습니다.v2 메서드 사용 정보는 메시징 사용 가이드에 참조하십시오.

CrossServerMessaging

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

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

메시지 게시

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

경험의 미리 정의된 주제에 메시지를 게시하여 메시지 크기가 최대 1,024자(1KB)일 수 있습니다.API 키에 대한 게시 권한과 OAuth 2.0 앱에 대한 유니버스 메시징 서비스:public 범위가 필요합니다.서버 간 메시징을 참조하여 사용자를 토픽에 정의하고 구독하세요.

매개 변수

universeId number

메시지를 보내고 싶은 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
topic string

메시지를 게시할 주제, 최대 80자.

Path
필수

응답

필요한 권한

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

  • 게시

한도
  • API 키: 사용자 또는 그룹의 모든 API 키에 분당 요청 5000건
  • OAuth 2.0: 앱 사용자당 분당 요청 5000건

참고: 트래픽이 많은 기간에는 속도 제한이 더 낮아질 수 있습니다. 일부 엔드포인트에는 속도 제한이 추가로 적용됩니다. 속도 제한에 대해서 자세히 알아보세요.

개체

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

PublishRequest

라이브 서버에 게시하려는 메시지 문자열이 있는 요청 본문 개체.

특성

message string

라이브 서버에 게시할 메시지 콘텐츠.