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
基本網址
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
Beta

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 '{}'
回應
{}