API de activos
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Assets
https://apis.roblox.com/assets
Listar versiones de activos
GET /assets/v1/assets/{assetId}/versions
Parámetros
assetId string
Path
Obligatorio
maxPageSize number
pageToken string
Solicitud
List Asset Versions
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions?pageToken=&maxPageSize=' \
--header 'x-api-key: {apiKey}'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Versión de activo de devolución
POST /assets/v1/assets/{assetId}/versions:rollback
Parámetros
assetId string
Path
Obligatorio
Solicitud
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}\"}'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Crear recurso
POST /v1/assets
Solicitud
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'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Obtener recurso
GET /v1/assets/{assetId}
Parámetros
assetId string
Path
Obligatorio
readMask string
Solicitud
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}'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Actualizar recurso
PATCH /v1/assets/{assetId}
Parámetros
assetId string
Path
Obligatorio
updateMask string
Solicitud
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
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=twitchSocialLink%2CgithubSocialLink' \
--header 'x-api-key: {apiKey}' \
--form 'request="{\"assetId\": \"{assetId}\", \"twitchSocialLink\": {\"title\": \"Optional title\", \"uri\": \"https://twitch.tv/your-channel\"}, \"githubSocialLink\": {\"title\": \"Optional title\", \"uri\": \"https://github.com/your-repo\"}}"'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Obtener versión de activo
GET /v1/assets/{assetId}/versions/{versionNumber}
Parámetros
assetId string
Path
Obligatorio
versionNumber string
Path
Obligatorio
Solicitud
Get Asset Version
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}/versions/{versionNumber}' \
--header 'x-api-key: {apiKey}'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Archivar activo
POST /v1/assets/{assetId}:archive
Parámetros
assetId string
Path
Obligatorio
Solicitud
Archive Asset
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:archive' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Restaurar activo
POST /v1/assets/{assetId}:restore
Parámetros
assetId string
Path
Obligatorio
Solicitud
Restore Asset
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:restore' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Obtener operación
GET /v1/operations/{operationId}
Parámetros
operationId string
Path
Obligatorio
Solicitud
Get Operation
curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \
--header 'x-api-key: {apiKey}'Respuesta
Otros códigos de estado
Permisos obligatorios
Límites
Objetos
Any
Atributos
@type string
Asset
Atributos
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
state string
AssetVersion
Atributos
creationContext object
moderationResult object
path string
CreationContext
Atributos
creator object
Obligatorio
expectedPrice number
Creator
Atributos
groupId number
userId number
ModerationResult
Atributos
moderationState string
Operation
Atributos
done boolean
error object
metadata object
path string
response object
Preview
Atributos
altText string
asset string
SocialLink
Atributos
title string
uri string
State
Atributos
string (enum): "Unspecified", "Active", "Archived"
Status
Atributos
code number
details array<object>
message string