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

Place

Mewakili tempat Roblox.

Atribut

pathstring

Jalur sumber daya dari tempat.

Format: universes/{universe_id}/places/{place_id}.

createTimestring
Hanya Output

戳 waktu di mana tempat itu dibuat. String ini diformat sebagai Timestamp.

updateTimestring
Hanya Output

Stempel waktu di mana tempat itu diperbarui. String ini diformat sebagai Timestamp.

displayNamestring

Nama tempat.

descriptionstring

Deskripsi tempat.

serverSizenumber

Jumlah maksimum pengguna yang diizinkan di satu server.

Base URL

https://apis.roblox.com
Resource Place

{
"path": "universes/123/places/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!",
"serverSize": "integer"
}

Place

Dapatkan Tempat

GET /cloud/v2/universes/{universe_id}/places/{place_id}

Mendapatkan tempat yang ditentukan.

Batas
  • Kunci API: 100 permintaan per menit di semua kunci API untuk pengguna atau grup
  • OAuth 2.0: 100 permintaan per menit per pengguna aplikasi

Catatan: Batas permintaan dapat lebih rendah selama periode traffic yang tinggi. Beberapa endpoint memiliki batas permintaan tambahan. Pelajari selengkapnya tentang batas permintaan.

PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

place_idstring
Diperlukan

ID tempat.

ResponsPlace
GET /cloud/v2/universes/{universe_id}/places/{place_id}

curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/places/{place_id}' \
-H 'x-api-key: {your-api-key}'
Respons

{
"path": "universes/123/places/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!",
"serverSize": "integer"
}

Place

Tempat Perbaruan

PATCH /cloud/v2/universes/{universe_id}/places/{place_id}

Memperbarui tempat yang ditentukan.

Cakupan
universe.place:write
Batas
  • Kunci API: 100 permintaan per menit di semua kunci API untuk pengguna atau grup
  • OAuth 2.0: 100 permintaan per menit per pengguna aplikasi

Catatan: Batas permintaan dapat lebih rendah selama periode traffic yang tinggi. Beberapa endpoint memiliki batas permintaan tambahan. Pelajari selengkapnya tentang batas permintaan.

PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

place_idstring
Diperlukan

ID tempat.

Parameter Kueri
updateMaskstring

Daftar bidang untuk diperbarui. String ini diformat sebagai FieldMask.

Request BodyPlace
ResponsPlace
PATCH /cloud/v2/universes/{universe_id}/places/{place_id}

curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/places/{place_id}?updateMask={string}' \
-H 'x-api-key: {your-api-key}' \
-H 'Content-Type: application/json' \
--data '{
"displayName": "ROBLOX Battle [OPEN]",
"description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
"serverSize": "integer"
}'
Respons

{
"path": "universes/123/places/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!",
"serverSize": "integer"
}