API delle risorse

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Assets

https://apis.roblox.com/assets

Elenca le versioni delle risorse

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

Parametri

assetId string
Path
Necessario
maxPageSize number
pageToken string

Richiesta

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

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

Risposta

Permessi Necessari

  • Leggi
  • asset:read

Limiti

Per chiave API: 60 richieste ogni 60 secondi per indirizzo IP

Versione della risorsa di ripristino

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

Parametri

assetId string
Path
Necessario
assetVersion string
FormData
Necessario

Richiesta

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}\"}'

Risposta

Permessi Necessari

  • Leggi
  • Scrivi
  • asset:read
  • asset:write

Limiti

Per chiave API: 60 richieste ogni 60 secondi per indirizzo IP

Ottieni risorsa

GET /v1/assets

Parametri

assetId
Path
Necessario
readMask string

Richiesta

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}'

Risposta

Permessi Necessari

  • Leggi
  • asset:read

Limiti

Per chiave API: 60 richieste ogni 60 secondi per indirizzo IP

Crea risorsa

POST /v1/assets

Parametri

request
FormData
Necessario
fileContent string
FormData
Necessario

Richiesta

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'

Risposta

200 - OK
Restituisce l'ID dell'operazione per controllare lo Statodella creazione.
Ritorna un(a) object
done boolean
error object
metadata object
path string
response object

Permessi Necessari

  • Leggi
  • Scrivi
  • asset:read
  • asset:write

Limiti

Per chiave API: 60 richieste ogni 60 secondi per indirizzo IP

Aggiorna risorsa

PATCH /v1/assets/{assetId}

Parametri

request
FormData
Necessario
fileContent string
FormData
updateMask string

Richiesta

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

Risposta

200 - OK
Restituisce l'ID dell'operazione per controllare lo stato dell'aggiornamento / Ritorna i campi metadati aggiornati.
Ritorna un(a) 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

Permessi Necessari

  • Leggi
  • Scrivi
  • asset:read
  • asset:write

Limiti

Per chiave API: 60 richieste ogni 60 secondi per indirizzo IP

Ottieni la versione dell'asset

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

Parametri

assetId string
Path
Necessario
versionNumber string
Path
Necessario

Richiesta

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

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

Risposta

Permessi Necessari

  • Leggi
  • asset:read

Limiti

Per chiave API: 60 richieste ogni 60 secondi per indirizzo IP

Ottieni Operazione

GET /v1/operations/{operationId}

Richiesta

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

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

Risposta

200 - OK
Ritorna un(a) object
done boolean
error object
metadata object
path string
response object

Permessi Necessari

  • Leggi
  • asset:read

Limiti

Per chiave API: 60 richieste ogni 60 secondi per indirizzo IP

Oggetti

Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.

Any

Attributi

@type string

Asset

Attributi

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

Attributi

creator object
Necessario
expectedPrice number

Creator

Attributi

groupId number
userId number

ModerationResult

Attributi

moderationState string

Operation

Attributi

done boolean
error object
metadata object
path string
response object

Preview

Attributi

altText string
asset string

Attributi

title string
uri string

Status

Attributi

code number
details array<object>
message string