API Aset

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

Assets

https://apis.roblox.com/assets

Daftar Versi Aset

GET /assets/v1/assets/{assetId}/versions

Parameter

assetId string
Path
Diperlukan
maxPageSize number
pageToken string

Permintaan

List Asset Versions
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions?pageToken=&maxPageSize=' \

--header 'x-api-key: {apiKey}'

Respons

Izin yang Diperlukan

  • Baca
  • asset:read

Batas

Per Kunci API: 60 permintaan setiap 60 detik per Alamat IP

Versi Aset Rollback

POST /assets/v1/assets/{assetId}/versions:rollback

Parameter

assetId string
Path
Diperlukan
assetVersion string
FormData
Diperlukan

Permintaan

Rollback Asset Versions
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions:rollback' \

--header 'x-api-key: {apiKey}' \

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

--data '{\"assetVersion\":\"assets/{assetId}/versions/{versionNumber}\"}'

Respons

Izin yang Diperlukan

  • Baca
  • Tulis
  • asset:read
  • asset:write

Batas

Per Kunci API: 60 permintaan setiap 60 detik per Alamat IP

Dapatkan Aset

GET /v1/assets

Parameter

assetId
Path
Diperlukan
readMask string

Permintaan

Get Asset without readMask
curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}' \

--header 'x-api-key: {apiKey}'
Get Asset with readMask
curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}?readMask={read_mask}' \

--header 'x-api-key: {apiKey}'

Respons

Izin yang Diperlukan

  • Baca
  • asset:read

Batas

Per Kunci API: 60 permintaan setiap 60 detik per Alamat IP

Buat Aset

POST /v1/assets

Parameter

request
FormData
Diperlukan
fileContent string
FormData
Diperlukan

Permintaan

Create Asset
curl --location --request POST 'https://apis.roblox.com/assets/v1/assets' \

--header 'x-api-key: {apiKey}' \

--form 'request="{ 

  \"assetType\": \"Model\",  

  \"displayName\": \"Name\", 

  \"description\": \"This is a description\", 

  \"creationContext\": { 

    \"creator\": { 

      \"userId\": \"${userId}\" 

    } 

  } 

}"' \

--form 'fileContent=@"/filepath/model.fbx";type=model/fbx'

Respons

200 - OK
Mengembalikan ID Operasi untuk memeriksa status pembuatan.
Memberikan nilai object
done boolean
error object
metadata object
path string
response object

Izin yang Diperlukan

  • Baca
  • Tulis
  • asset:read
  • asset:write

Batas

Per Kunci API: 60 permintaan setiap 60 detik per Alamat IP

Perbarui Aset

PATCH /v1/assets/{assetId}

Parameter

request
FormData
Diperlukan
fileContent string
FormData
updateMask string

Permintaan

Update Content Only and Create a New Version
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}' \

--header 'x-api-key: {apiKey}' \

--form 'request="{\"assetId\": {assetId} }"' \

--form 'fileContent="@\"{file-path}\""'
Update Content and Metadata
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=description%2CdisplayName' \

--header 'x-api-key: {apiKey}' \

--form 'request="{

    \"assetType\": \"{assetType}\",

    \"assetId\": {assetId},

    \"displayName\": \"{new display name}\",

    \"description\": \"{new description}\",    

    \"creationContext\": { 

        \"creator\": {

            \"userId\": {userId}

        },

        \"expectedPrice\":{expectedPrice}

    },

}"' \

--form 'fileContent=@\"{file-path}\"'
Update a List of Previews
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=previews' \

--header 'x-api-key: {apiKey}' \

--form 'request="{\"assetId\": \"{assetId}\", \"previews\": [{\"asset\": \"assets/123\", \"altText\": \"Your alt text.\"}]}"'
Update Social Links

Respons

200 - OK
Mengembalikan ID Operasi untuk memeriksa status pembaruan / Mengembalikan field metadaten yang diperbarui.
Memberikan nilai object
application/json
{\"previews\": [\n    {\"asset\": \"assets/123\", \"altText\": \"preview 1\"},\n    {\"asset\": \"assets/456\", \"altText\": \"preview 2\"}\n]}
done boolean
error object
metadata object
path string
response object

Izin yang Diperlukan

  • Baca
  • Tulis
  • asset:read
  • asset:write

Batas

Per Kunci API: 60 permintaan setiap 60 detik per Alamat IP

Dapatkan Versi Aset

GET /v1/assets/{assetId}/versions/{versionNumber}

Parameter

assetId string
Path
Diperlukan
versionNumber string
Path
Diperlukan

Permintaan

Get Asset Version
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}/versions/{versionNumber}' \

--header 'x-api-key: {apiKey}'

Respons

Izin yang Diperlukan

  • Baca
  • asset:read

Batas

Per Kunci API: 60 permintaan setiap 60 detik per Alamat IP

Dapatkan Operasi

GET /v1/operations/{operationId}

Permintaan

Get Operation
curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \

--header 'x-api-key: {apiKey}'

Respons

200 - OK
Memberikan nilai object
done boolean
error object
metadata object
path string
response object

Izin yang Diperlukan

  • Baca
  • asset:read

Batas

Per Kunci API: 60 permintaan setiap 60 detik per Alamat IP

Objek

Objek berikut mendeskripsikan muatan yang diterima atau diberikan. Lihat masing-masing endpoint untuk mengetahui informasi selengkapnya tentang waktu penggunaan objek ini.

Any

Atribut

@type string

Asset

Atribut

assetId number
assetType string
creationContext object
description string
displayName string
icon string
moderationResult object
path string
previews array<object>
revisionCreateTime string
revisionId string
socialLink object

CreationContext

Atribut

creator object
Diperlukan
expectedPrice number

Creator

Atribut

groupId number
userId number

ModerationResult

Atribut

moderationState string

Operation

Atribut

done boolean
error object
metadata object
path string
response object

Preview

Atribut

altText string
asset string

Atribut

title string
uri string

Status

Atribut

code number
details array<object>
message string