Universe

특성

pathstring
createTimestring
출력 전용
updateTimestring
출력 전용
displayNamestring
출력 전용
descriptionstring
출력 전용

owner에 대해 다음 중 하나 선택 가능:

userstring
출력 전용
groupstring
출력 전용
visibilityEnum<string>
출력 전용
facebookSocialLinkobject
twitterSocialLinkobject
youtubeSocialLinkobject
twitchSocialLinkobject
discordSocialLinkobject
robloxGroupSocialLinkobject
guildedSocialLinkobject
voiceChatEnabledboolean
ageRatingEnum<string>
출력 전용
privateServerPriceRobuxnumber
desktopEnabledboolean
mobileEnabledboolean
tabletEnabledboolean
consoleEnabledboolean
vrEnabledboolean
기본 URL
https://apis.roblox.com
Universe 리소스
{

  "path": "universes/123",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "displayName": "ROBLOX Battle [OPEN]",

  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",

  "user": "string",

  "visibility": "VISIBILITY_UNSPECIFIED",

  "facebookSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitterSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "youtubeSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitchSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "discordSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "robloxGroupSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "guildedSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "voiceChatEnabled": true,

  "ageRating": "AGE_RATING_UNSPECIFIED",

  "privateServerPriceRobux": "integer",

  "desktopEnabled": true,

  "mobileEnabled": true,

  "tabletEnabled": true,

  "consoleEnabled": true,

  "vrEnabled": true

}

Universe

Get Universe

GET /cloud/v2/universes/{universe_id}
요청경로 매개 변수
universe_idstring
필수
응답Universe
GET /cloud/v2/universes/{universe_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}' \

  -H 'x-api-key: {your-api-key}'
응답
{

  "path": "universes/123",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "displayName": "ROBLOX Battle [OPEN]",

  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",

  "user": "string",

  "visibility": "VISIBILITY_UNSPECIFIED",

  "facebookSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitterSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "youtubeSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitchSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "discordSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "robloxGroupSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "guildedSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "voiceChatEnabled": true,

  "ageRating": "AGE_RATING_UNSPECIFIED",

  "privateServerPriceRobux": "integer",

  "desktopEnabled": true,

  "mobileEnabled": true,

  "tabletEnabled": true,

  "consoleEnabled": true,

  "vrEnabled": true

}

Universe

Update Universe

PATCH /cloud/v2/universes/{universe_id}
범위
universe:write
요청경로 매개 변수
universe_idstring
필수
쿼리 매개 변수
updateMaskstring
요청 본문Universe
응답Universe
PATCH /cloud/v2/universes/{universe_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}?updateMask={string}' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "facebookSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitterSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "youtubeSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitchSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "discordSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "robloxGroupSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "guildedSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "voiceChatEnabled": true,

  "privateServerPriceRobux": "integer",

  "desktopEnabled": true,

  "mobileEnabled": true,

  "tabletEnabled": true,

  "consoleEnabled": true,

  "vrEnabled": true

}'
응답
{

  "path": "universes/123",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "displayName": "ROBLOX Battle [OPEN]",

  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",

  "user": "string",

  "visibility": "VISIBILITY_UNSPECIFIED",

  "facebookSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitterSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "youtubeSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitchSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "discordSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "robloxGroupSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "guildedSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "voiceChatEnabled": true,

  "ageRating": "AGE_RATING_UNSPECIFIED",

  "privateServerPriceRobux": "integer",

  "desktopEnabled": true,

  "mobileEnabled": true,

  "tabletEnabled": true,

  "consoleEnabled": true,

  "vrEnabled": true

}

Universe

Publish Universe Message
베타

POST /cloud/v2/universes/{universe_id}:publishMessage
범위
universe-messaging-service:publish
요청경로 매개 변수
universe_idstring
필수
요청 본문
topicstring
messagestring
POST /cloud/v2/universes/{universe_id}:publishMessage
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}:publishMessage' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "topic": "my-topic",

  "message": "Hello, world!"

}'

Universe

Restart Universe Servers

POST /cloud/v2/universes/{universe_id}:restartServers
범위
universe:write
요청경로 매개 변수
universe_idstring
필수
요청 본문
응답
POST /cloud/v2/universes/{universe_id}:restartServers
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}:restartServers' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{}'
응답
{}