API (Interface de Programação para Aplicações)de Recursos

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Você pode enviar e receber os seguintes pedidos e respostas para criar recursos no Roblox.Para obter informações sobre o uso da API (Interface de Programação para Aplicações), consulte o guia de uso.

Assets

https://apis.roblox.com/assets

Listar Versões de Recursos

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

Liste todas as versões de um ativoespecífico, com paginação opcional.

Parâmetros

assetId string

O identificador exclusivo do ativo.

Path
Obrigatório
maxPageSize number

Specifica o número de versões de recursos a incluir na resposta. Os valores válidos variam de 1 a 50 (inclusivo). Padrão para 8 quando não fornecido.

pageToken string

Um token para paginação. O valor é obtido a partir de uma solicitação anterior e permite recuperar a próxima página de versões de recursos.

Solicitação

List Asset Versions

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions?pageToken=&maxPageSize=' \
--header 'x-api-key: {apiKey}'

Resposta

200 - OK
Versões de recursos listadas com sucesso.
Retorna um(a) array<object>

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

Limites

Por chave de API: 100 solicitações a cada 60 segundos por endereço IP

Versão de Recursos de Retrocesso

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

Rolar um recurso de volta para uma versão anterior específica.

Forneça o caminho da versão do recurso no formulário de dados.

Parâmetros

assetId string

O identificador exclusivo do ativo.

Path
Obrigatório

Solicitação

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

Resposta

200 - OK
Ativo revertido com sucesso.
Retorna um(a) object
creationContext object

O contexto de criação que não faz parte do conteúdo do recurso, como metadados e informações do criador. Necessário para Criar Recurso.

moderationResult object

O resultado de moderação do ativo.

path string

O caminho de recursos retornado da versão do recurso. Formato: assets/{assetId}/versions/{version} . Exemplo: assets/2205400862/versions/1 .

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

  • Escrever

Limites

Por chave de API: 100 solicitações a cada 60 segundos por endereço IP

Criar Recurso

POST /v1/assets

Cria um recurso com conteúdo e metadados fornecidos.

Você não pode adicionar objetos SocialLink quando cria um recurso. Em vez disso, use Atualizar Recurso.

Forneça o Recurso, caminho de arquivo de recurso binário, e tipo de conteúdo na forma de dados.

Solicitação

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'

Resposta

200 - OK
Retorna o ID da Operação para verificar o status de criação.
Retorna um(a) object
done boolean

Se false , a operação ainda está em andamento. Se true , a operação é concluída.

error object

O modelo de erro lógico que explica o status de erro.

metadata object

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

path string

O caminho de recursos atribuído pelo servidor. O formato padrão é operations/{operation_id} .

response object

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

  • Escrever

Limites

Por chave de API: 60 solicitações a cada 60 segundos por endereço IP

Obter recurso

GET /v1/assets/{assetId}

Recupere conteúdo e metadados de ativos específicos.

Parâmetros

assetId string

O identificador exclusivo do ativo.

Path
Obrigatório
readMask string

Campos de metadados de recursos para recuperar, incluindo a descrição, o Nome de exibiçãode exibição, o ícone, os links sociais e as visualizações. Exemplos: description%2CdisplayName , previews%2CtwitchSocialLink .

Solicitação

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

Resposta

200 - OK
Recurso de ativo recuperado com sucesso.
Retorna um(a) object
assetId number

O identificador exclusivo do recurso. Necessário para Atualizar Recurso.

assetType string

O digitarde recurso. Só pode ser Audio , Decal ou Model . Necessário para Criar Recurso .

creationContext object

O contexto de criação que não faz parte do conteúdo do recurso, como metadados e informações do criador. Necessário para Criar Recurso.

description string

A descrição do ativo. Limite de 1000 caracteres. Necessário para Criar Recurso.

displayName string

Nome de exibição do ativo. Necessário para Criar Recurso.

icon string

O caminho de recursos para o ícone.

moderationResult object

O resultado de moderação do ativo.

path string

O caminho de recursos retornado da ativo. Formato: assets/{assetId} . Exemplo: assets/2205400862 .

previews array<object>

Uma lista de pré-visualizações, cada uma com um caminho de recurso e texto alternativo. As pré-visualizações devem ser Imagem recursos.

revisionCreateTime string

O tempo de criação da revisão atual.

revisionId string

ID de revisão do ativo.Equivalente a versionNumber.Cada alteração do recurso envia automaticamente uma nova versão.O formato é uma string / cadeia / textointeira.Exemplo: 1 .

socialLink object

Um link de mídia social para o recurso.Máximo de três por ativo.O nome do objeto pode ser qualquer um dos seguintes:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Para síntese, veja o pedido de exemplo sob Atualizar Recurso .

state string

Se o recurso está ativo ou arquivado. Não especificado não é usado.

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

Limites

Por chave de API: 60 solicitações a cada 60 segundos por endereço IP

Atualizar recurso

PATCH /v1/assets/{assetId}

Atualiza um recurso com conteúdo e metadados fornecidos, incluindo a descrição, o nome de exibição, o ícone, os links sociais e as visualizações.Atualmente, só é possível atualizar o corpo do conteúdo para Modelos .Ícones e Pré-visualizações devem ser imagens de recursos.Ícones devem ter dimensões quadradas.

Forneça o Recurso, caminho de arquivo de recurso binário, e tipo de conteúdo na forma de dados.

Parâmetros

assetId string

O identificador exclusivo do ativo.

Path
Obrigatório
updateMask string

Campos de metadados de recursos para atualização, incluindo a descrição, o nome de exibição, o ícone e as visualizações. Exemplos: description%2CdisplayName , previews%2CtwitchSocialLink .

Solicitação

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

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

Resposta

200 - OK
Retorna o ID da Operação para verificar o status da atualização/Retorna os campos de metadados atualizados.
Retorna um(a) object
application/json

{"previews": [
{"asset": "assets/123", "altText": "preview 1"},
{"asset": "assets/456", "altText": "preview 2"}
]}
done boolean

Se false , a operação ainda está em andamento. Se true , a operação é concluída.

error object

O modelo de erro lógico que explica o status de erro.

metadata object

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

path string

O caminho de recursos atribuído pelo servidor. O formato padrão é operations/{operation_id} .

response object

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

  • Escrever

Limites

Por chave de API: 60 solicitações a cada 60 segundos por endereço IP

Obtenha a versão do recurso

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

Recupere uma versão específica de um recurso pelo ID do recurso e pelo número da versão.

Parâmetros

assetId string

O identificador exclusivo do ativo.

Path
Obrigatório
versionNumber string

O número da versão.

Path
Obrigatório

Solicitação

Get Asset Version

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}/versions/{versionNumber}' \
--header 'x-api-key: {apiKey}'

Resposta

200 - OK
Versão de recurso recuperada com sucesso.
Retorna um(a) object
creationContext object

O contexto de criação que não faz parte do conteúdo do recurso, como metadados e informações do criador. Necessário para Criar Recurso.

moderationResult object

O resultado de moderação do ativo.

path string

O caminho de recursos retornado da versão do recurso. Formato: assets/{assetId}/versions/{version} . Exemplo: assets/2205400862/versions/1 .

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

Limites

Por chave de API: 100 solicitações a cada 60 segundos por endereço IP

Recurso de Arquivo

POST /v1/assets/{assetId}:archive

Arquiva o ativo.Recursos arquivados desaparecem do site e não são mais utilizáveis ou visíveis nas experiências do Roblox, mas você pode restaurá-los.

Parâmetros

assetId string

O identificador exclusivo do ativo.

Path
Obrigatório

Solicitação

Archive Asset

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:archive' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'

Resposta

200 - OK
Recurso arquivado com sucesso.
Retorna um(a) object
assetId number

O identificador exclusivo do recurso. Necessário para Atualizar Recurso.

assetType string

O digitarde recurso. Só pode ser Audio , Decal ou Model . Necessário para Criar Recurso .

creationContext object

O contexto de criação que não faz parte do conteúdo do recurso, como metadados e informações do criador. Necessário para Criar Recurso.

description string

A descrição do ativo. Limite de 1000 caracteres. Necessário para Criar Recurso.

displayName string

Nome de exibição do ativo. Necessário para Criar Recurso.

icon string

O caminho de recursos para o ícone.

moderationResult object

O resultado de moderação do ativo.

path string

O caminho de recursos retornado da ativo. Formato: assets/{assetId} . Exemplo: assets/2205400862 .

previews array<object>

Uma lista de pré-visualizações, cada uma com um caminho de recurso e texto alternativo. As pré-visualizações devem ser Imagem recursos.

revisionCreateTime string

O tempo de criação da revisão atual.

revisionId string

ID de revisão do ativo.Equivalente a versionNumber.Cada alteração do recurso envia automaticamente uma nova versão.O formato é uma string / cadeia / textointeira.Exemplo: 1 .

socialLink object

Um link de mídia social para o recurso.Máximo de três por ativo.O nome do objeto pode ser qualquer um dos seguintes:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Para síntese, veja o pedido de exemplo sob Atualizar Recurso .

state string

Se o recurso está ativo ou arquivado. Não especificado não é usado.

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

  • Escrever

Limites

Por chave de API: 100 solicitações a cada 60 segundos por endereço IP

Restaurar Recurso

POST /v1/assets/{assetId}:restore

Restaura um recurso arquivado.

Parâmetros

assetId string

O identificador exclusivo do ativo.

Path
Obrigatório

Solicitação

Restore Asset

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:restore' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'

Resposta

200 - OK
Recurso restaurado com sucesso.
Retorna um(a) object
assetId number

O identificador exclusivo do recurso. Necessário para Atualizar Recurso.

assetType string

O digitarde recurso. Só pode ser Audio , Decal ou Model . Necessário para Criar Recurso .

creationContext object

O contexto de criação que não faz parte do conteúdo do recurso, como metadados e informações do criador. Necessário para Criar Recurso.

description string

A descrição do ativo. Limite de 1000 caracteres. Necessário para Criar Recurso.

displayName string

Nome de exibição do ativo. Necessário para Criar Recurso.

icon string

O caminho de recursos para o ícone.

moderationResult object

O resultado de moderação do ativo.

path string

O caminho de recursos retornado da ativo. Formato: assets/{assetId} . Exemplo: assets/2205400862 .

previews array<object>

Uma lista de pré-visualizações, cada uma com um caminho de recurso e texto alternativo. As pré-visualizações devem ser Imagem recursos.

revisionCreateTime string

O tempo de criação da revisão atual.

revisionId string

ID de revisão do ativo.Equivalente a versionNumber.Cada alteração do recurso envia automaticamente uma nova versão.O formato é uma string / cadeia / textointeira.Exemplo: 1 .

socialLink object

Um link de mídia social para o recurso.Máximo de três por ativo.O nome do objeto pode ser qualquer um dos seguintes:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Para síntese, veja o pedido de exemplo sob Atualizar Recurso .

state string

Se o recurso está ativo ou arquivado. Não especificado não é usado.

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

  • Escrever

Limites

Por chave de API: 100 solicitações a cada 60 segundos por endereço IP

Obter Operação

GET /v1/operations/{operationId}

Obtenha o resultado de uma criação ou atualização de recurso usando o ID de operação retornado.Requer Leitura para a permissão da chave da API e leitura de recursos para aplicativos do OAuth 2.0.

Parâmetros

operationId string

O identificador exclusivo da operação.

Path
Obrigatório

Solicitação

Get Operation

curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \
--header 'x-api-key: {apiKey}'

Resposta

200 - OK
Resultado da operação recuperado com sucesso.
Retorna um(a) object
done boolean

Se false , a operação ainda está em andamento. Se true , a operação é concluída.

error object

O modelo de erro lógico que explica o status de erro.

metadata object

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

path string

O caminho de recursos atribuído pelo servidor. O formato padrão é operations/{operation_id} .

response object

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

Permissões necessárias

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja Gerenciando chaves API.

  • Ler

Limites

Por chave de API: 100 solicitações a cada 60 segundos por endereço IP

Objetos

Os seguintes objetos descrevem payloads que são aceitos ou retornados. Veja cada endpoint para mais informações sobre quando esses objetos são usados.

Any

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

Atributos

@type string

O tipo da mensagem serializada.

Asset

Representa um ativo.

Atributos

assetId number

O identificador exclusivo do recurso. Necessário para Atualizar Recurso.

assetType string

O digitarde recurso. Só pode ser Audio , Decal ou Model . Necessário para Criar Recurso .

creationContext object

O contexto de criação que não faz parte do conteúdo do recurso, como metadados e informações do criador. Necessário para Criar Recurso.

description string

A descrição do ativo. Limite de 1000 caracteres. Necessário para Criar Recurso.

displayName string

Nome de exibição do ativo. Necessário para Criar Recurso.

icon string

O caminho de recursos para o ícone.

moderationResult object

O resultado de moderação do ativo.

path string

O caminho de recursos retornado da ativo. Formato: assets/{assetId} . Exemplo: assets/2205400862 .

previews array<object>

Uma lista de pré-visualizações, cada uma com um caminho de recurso e texto alternativo. As pré-visualizações devem ser Imagem recursos.

revisionCreateTime string

O tempo de criação da revisão atual.

revisionId string

ID de revisão do ativo.Equivalente a versionNumber.Cada alteração do recurso envia automaticamente uma nova versão.O formato é uma string / cadeia / textointeira.Exemplo: 1 .

socialLink object

Um link de mídia social para o recurso.Máximo de três por ativo.O nome do objeto pode ser qualquer um dos seguintes:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Para síntese, veja o pedido de exemplo sob Atualizar Recurso .

state string

Se o recurso está ativo ou arquivado. Não especificado não é usado.

AssetVersion

Uma versão de recurso.

Atributos

creationContext object

O contexto de criação que não faz parte do conteúdo do recurso, como metadados e informações do criador. Necessário para Criar Recurso.

moderationResult object

O resultado de moderação do ativo.

path string

O caminho de recursos retornado da versão do recurso. Formato: assets/{assetId}/versions/{version} . Exemplo: assets/2205400862/versions/1 .

CreationContext

O contexto de criação que não faz parte do conteúdo do recurso, como metadados e informações do criador. Necessário para Criar Recurso.

Atributos

creator object

Representa um criador.

Obrigatório
expectedPrice number

Taxa de upload de recurso esperada em Robux. Quando o preço real for maior do que o esperado, a operação falha com um erro de 400.

Creator

Representa um criador.

Atributos

groupId number

O ID do Grupo. Necessário se o recurso for de propriedade do grupo.

userId number

O ID do Usuário do criador. Necessário se o recurso for de propriedade de um único usuário.

ModerationResult

O resultado de moderação do ativo.

Atributos

moderationState string

O estado de moderação do ativo. Pode ser Reviewing, Rejected ou Approved.

Operation

Este recurso representa uma operação de longa duração que é o resultado de uma chamada de API de rede.

Atributos

done boolean

Se false , a operação ainda está em andamento. Se true , a operação é concluída.

error object

O modelo de erro lógico que explica o status de erro.

metadata object

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

path string

O caminho de recursos atribuído pelo servidor. O formato padrão é operations/{operation_id} .

response object

Contém uma mensagem serializada arbitrária junto com um @type que descreve o tipo da mensagem serializada.

Preview

Uma prévia de recurso.

Atributos

altText string

Texto alternativo para o recurso de pré-visualização.

asset string

O caminho de pré-visualização de recursos.

Um link de mídia social para o recurso.Máximo de três por ativo.O nome do objeto pode ser qualquer um dos seguintes:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Para síntese, veja o pedido de exemplo sob Atualizar Recurso .

Atributos

title string

Um título opcional para o víncular / conectarde mídia social. Não usado no Hub do Criador.

uri string

O URI para o víncular / conectarde mídia social.Deve corresponder ao formato esperado para o tipo de víncular / conectar.Por exemplo, o título de um objeto twitchSocialLink deve ser do formato https://twitch.tv/your-channel.

State

Se o recurso está ativo ou arquivado. Não especificado não é usado.

Atributos

string (enum): "Unspecified", "Active", "Archived"

Status

O modelo de erro lógico que explica o status de erro.

Atributos

code number

O código de status HTTP.

details array<object>

Uma lista de mensagens que carregam detalhes de erro.

message string

A mensagem de erro.