API des ressources

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Vous pouvez envoyer et recevoir les charges utiles de requête et de réponse suivantes pour créer des ressources sur Roblox.Pour obtenir des informations sur l'utilisation de l'API, voir le guide d'utilisation.

Assets

https://apis.roblox.com/assets

Listez les versions des ressources

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

Listez toutes les versions d'un contenuspécifique, avec une pagination facultative.

Paramètres

assetId string

L'identifiant unique de la contenu.

Path
Requis
maxPageSize number

Spécifie le nombre de versions de ressources à inclure dans la réponse. Les valeurs valides vont de 1 à 50 (inclus). La valeur par défaut est de 8 lorsqu'elle n'est pas fournie.

pageToken string

Un jeton pour la pagination. La valeur est obtenue à partir d'une demande précédente et permet de récupérer la page suivante des versions de ressources.

Requête

List Asset Versions

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

Réponse

200 - OK
Version des ressources listées avec succès.
Renvoie une array<object>

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

Limitations

Par clé API : 100 demande toutes les 60 secondes par adresse IP

Version de la ressource de rétrogradation

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

Revenir une ressource à une version précédente spécifique.

Fournir le chemin de version des ressources dans les données de formulaire.

Paramètres

assetId string

L'identifiant unique de la contenu.

Path
Requis

Requête

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

Réponse

200 - OK
Actif roulé en arrière avec succès.
Renvoie une object
creationContext object

Le contexte de création qui n'est pas partie du contenu des ressources, comme les métadonnées et les informations sur le créateur. Nécessaire pour créer une ressource.

moderationResult object

Le résultat de modération de la contenu.

path string

Le chemin de ressource retourné de la version de l'actif. Format : assets/{assetId}/versions/{version} . Exemple : assets/2205400862/versions/1 .

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

  • Écrire

Limitations

Par clé API : 100 demande toutes les 60 secondes par adresse IP

Créer une ressource

POST /v1/assets

Crée une ressource avec le contenu et les métadonnées fournis.

Vous ne pouvez pas ajouter d'objets Lien social lorsque vous créez une contenu. Utilisez plutôt mettre à jour la ressource.

Fournir le Asset , le chemin du fichier de ressources binaires, et le type de contenu dans les données de formulaire.

Requête

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'

Réponse

200 - OK
Renvoie l'ID de l'opération pour vérifier le statut de création.
Renvoie une object
done boolean

Si false , l'opération est toujours en cours. Si true , l'opération est terminée.

error object

Le modèle d'erreur logique expliquant l'statutd'erreur.

metadata object

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

path string

Le chemin de ressource attribué par le serveur. Le format par défaut est operations/{operation_id} .

response object

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

  • Écrire

Limitations

Par clé API : 60 demande toutes les 60 secondes par adresse IP

Obtenir une ressource

GET /v1/assets/{assetId}

Récupérer le contenu et les métadonnées des ressources spécifiques.

Paramètres

assetId string

L'identifiant unique de la contenu.

Path
Requis
readMask string

Champs de métadonnées de ressources à récupérer, y compris la description, le nom d'affichage, l'icône, les liens sociaux et les prévisualisations. Exemples : description%2CdisplayName , previews%2CtwitchSocialLink .

Requête

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

Réponse

200 - OK
Ressource d'actif récupérée avec succès.
Renvoie une object
assetId number

L'identifiant unique de la contenu. Nécessaire pour mettre à jour la ressource.

assetType string

Le taperde ressource. Ne peut être que Audio , Decal ou Model . Requis pour Créer une ressource .

creationContext object

Le contexte de création qui n'est pas partie du contenu des ressources, comme les métadonnées et les informations sur le créateur. Nécessaire pour créer une ressource.

description string

La description de la contenu. Limite à 1000 caractères. Nécessaire pour créer une ressource.

displayName string

Nom d'affichage de la contenu. Nécessaire pour créer une ressource.

icon string

Le chemin de ressource pour l'icône.

moderationResult object

Le résultat de modération de la contenu.

path string

Le chemin de ressource retourné de la contenu. Format : assets/{assetId} . Exemple : assets/2205400862 .

previews array<object>

Une liste d'aperçus, chacun avec un chemin de ressources et du texte alt. Les aperçus doivent être des ressources image .

revisionCreateTime string

L'heure de création de la révision actuelle.

revisionId string

ID de révision de la contenu.Équivalent à versionNumber.Chaque modification de la ressource engage automatiquement une nouvelle version.Le format est une chaîne entière.Exemple : 1 .

socialLink object

Un lien de média social pour la contenu.Maximum de trois par contenu.Le nom de l'objet peut être n'importe lequel de :

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Pour la syntaxe, voir la demande d'échantillon sous Mise à jour des ressources .

state string

Si la ressource est active ou archivée. Non spécifié n'est pas utilisé.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

Limitations

Par clé API : 60 demande toutes les 60 secondes par adresse IP

Mettre à jour la ressource

PATCH /v1/assets/{assetId}

Mise à jour d'une ressource avec le contenu et les métadonnées fournis, y compris la description, le nom d'affichage, l'icône, les liens sociaux et les prévisualisations.Actuellement, vous ne pouvez mettre à jour le corps du contenu que pour modèles .Les icônes et les prévisualisations doivent être des ressources image .Les icônes doivent avoir des dimensions carrées.

Fournir le Asset , le chemin du fichier de ressources binaires, et le type de contenu dans les données de formulaire.

Paramètres

assetId string

L'identifiant unique de la contenu.

Path
Requis
updateMask string

Champs de métadonnées de ressources à mettre à mise à jour, y compris la description, le Nom d'affichaged'affichage, l'icône et les prévisualisations. Exemples : description%2CdisplayName , previews%2CtwitchSocialLink .

Requête

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

Réponse

200 - OK
Renvoie l'ID de l'opération pour vérifier le statut de la mise à jour/Renvoie les champs de métadonnées mis à jour.
Renvoie une object
application/json

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

Si false , l'opération est toujours en cours. Si true , l'opération est terminée.

error object

Le modèle d'erreur logique expliquant l'statutd'erreur.

metadata object

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

path string

Le chemin de ressource attribué par le serveur. Le format par défaut est operations/{operation_id} .

response object

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

  • Écrire

Limitations

Par clé API : 60 demande toutes les 60 secondes par adresse IP

Obtenir la version des ressources

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

Récupérer une version spécifique de la ressource par l'ID de la ressource et le numéro de version.

Paramètres

assetId string

L'identifiant unique de la contenu.

Path
Requis
versionNumber string

Le numéro de version.

Path
Requis

Requête

Get Asset Version

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

Réponse

200 - OK
Version des ressources récupérée avec succès.
Renvoie une object
creationContext object

Le contexte de création qui n'est pas partie du contenu des ressources, comme les métadonnées et les informations sur le créateur. Nécessaire pour créer une ressource.

moderationResult object

Le résultat de modération de la contenu.

path string

Le chemin de ressource retourné de la version de l'actif. Format : assets/{assetId}/versions/{version} . Exemple : assets/2205400862/versions/1 .

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

Limitations

Par clé API : 100 demande toutes les 60 secondes par adresse IP

Ressource d'archive

POST /v1/assets/{assetId}:archive

Archivage de la contenu.Les ressources archivées disparaissent du site Web et ne sont plus utilisables ou visibles dans les expériences Roblox, mais vous pouvez les restaurer.

Paramètres

assetId string

L'identifiant unique de la contenu.

Path
Requis

Requête

Archive Asset

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

Réponse

200 - OK
Ressource archivée avec succès.
Renvoie une object
assetId number

L'identifiant unique de la contenu. Nécessaire pour mettre à jour la ressource.

assetType string

Le taperde ressource. Ne peut être que Audio , Decal ou Model . Requis pour Créer une ressource .

creationContext object

Le contexte de création qui n'est pas partie du contenu des ressources, comme les métadonnées et les informations sur le créateur. Nécessaire pour créer une ressource.

description string

La description de la contenu. Limite à 1000 caractères. Nécessaire pour créer une ressource.

displayName string

Nom d'affichage de la contenu. Nécessaire pour créer une ressource.

icon string

Le chemin de ressource pour l'icône.

moderationResult object

Le résultat de modération de la contenu.

path string

Le chemin de ressource retourné de la contenu. Format : assets/{assetId} . Exemple : assets/2205400862 .

previews array<object>

Une liste d'aperçus, chacun avec un chemin de ressources et du texte alt. Les aperçus doivent être des ressources image .

revisionCreateTime string

L'heure de création de la révision actuelle.

revisionId string

ID de révision de la contenu.Équivalent à versionNumber.Chaque modification de la ressource engage automatiquement une nouvelle version.Le format est une chaîne entière.Exemple : 1 .

socialLink object

Un lien de média social pour la contenu.Maximum de trois par contenu.Le nom de l'objet peut être n'importe lequel de :

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Pour la syntaxe, voir la demande d'échantillon sous Mise à jour des ressources .

state string

Si la ressource est active ou archivée. Non spécifié n'est pas utilisé.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

  • Écrire

Limitations

Par clé API : 100 demande toutes les 60 secondes par adresse IP

Récupérer la ressource

POST /v1/assets/{assetId}:restore

Restaure une ressource archivée.

Paramètres

assetId string

L'identifiant unique de la contenu.

Path
Requis

Requête

Restore Asset

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

Réponse

200 - OK
Actif restauré avec succès.
Renvoie une object
assetId number

L'identifiant unique de la contenu. Nécessaire pour mettre à jour la ressource.

assetType string

Le taperde ressource. Ne peut être que Audio , Decal ou Model . Requis pour Créer une ressource .

creationContext object

Le contexte de création qui n'est pas partie du contenu des ressources, comme les métadonnées et les informations sur le créateur. Nécessaire pour créer une ressource.

description string

La description de la contenu. Limite à 1000 caractères. Nécessaire pour créer une ressource.

displayName string

Nom d'affichage de la contenu. Nécessaire pour créer une ressource.

icon string

Le chemin de ressource pour l'icône.

moderationResult object

Le résultat de modération de la contenu.

path string

Le chemin de ressource retourné de la contenu. Format : assets/{assetId} . Exemple : assets/2205400862 .

previews array<object>

Une liste d'aperçus, chacun avec un chemin de ressources et du texte alt. Les aperçus doivent être des ressources image .

revisionCreateTime string

L'heure de création de la révision actuelle.

revisionId string

ID de révision de la contenu.Équivalent à versionNumber.Chaque modification de la ressource engage automatiquement une nouvelle version.Le format est une chaîne entière.Exemple : 1 .

socialLink object

Un lien de média social pour la contenu.Maximum de trois par contenu.Le nom de l'objet peut être n'importe lequel de :

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Pour la syntaxe, voir la demande d'échantillon sous Mise à jour des ressources .

state string

Si la ressource est active ou archivée. Non spécifié n'est pas utilisé.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

  • Écrire

Limitations

Par clé API : 100 demande toutes les 60 secondes par adresse IP

Obtenir une opération

GET /v1/operations/{operationId}

Obtenez le résultat d'une création ou d'une mise à jour d'une ressource en utilisant l'ID d'opération retourné.Nécessite lecture pour l'autorisation de clé API et lecture de ressources pour les applications OAuth 2.0.

Paramètres

operationId string

L'identifiant unique de l'opération.

Path
Requis

Requête

Get Operation

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

Réponse

200 - OK
Résultat d'opération récupéré avec succès.
Renvoie une object
done boolean

Si false , l'opération est toujours en cours. Si true , l'opération est terminée.

error object

Le modèle d'erreur logique expliquant l'statutd'erreur.

metadata object

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

path string

Le chemin de ressource attribué par le serveur. Le format par défaut est operations/{operation_id} .

response object

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

Limitations

Par clé API : 100 demande toutes les 60 secondes par adresse IP

Objets

Les objets suivants décrivent les charges utiles qui sont acceptées ou renvoyées. Voir chaque point de terminaison individuel pour plus d'informations sur l'utilisation de ces objets.

Any

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

Attributs

@type string

Le type du message sérialisé.

Asset

Représente une contenu.

Attributs

assetId number

L'identifiant unique de la contenu. Nécessaire pour mettre à jour la ressource.

assetType string

Le taperde ressource. Ne peut être que Audio , Decal ou Model . Requis pour Créer une ressource .

creationContext object

Le contexte de création qui n'est pas partie du contenu des ressources, comme les métadonnées et les informations sur le créateur. Nécessaire pour créer une ressource.

description string

La description de la contenu. Limite à 1000 caractères. Nécessaire pour créer une ressource.

displayName string

Nom d'affichage de la contenu. Nécessaire pour créer une ressource.

icon string

Le chemin de ressource pour l'icône.

moderationResult object

Le résultat de modération de la contenu.

path string

Le chemin de ressource retourné de la contenu. Format : assets/{assetId} . Exemple : assets/2205400862 .

previews array<object>

Une liste d'aperçus, chacun avec un chemin de ressources et du texte alt. Les aperçus doivent être des ressources image .

revisionCreateTime string

L'heure de création de la révision actuelle.

revisionId string

ID de révision de la contenu.Équivalent à versionNumber.Chaque modification de la ressource engage automatiquement une nouvelle version.Le format est une chaîne entière.Exemple : 1 .

socialLink object

Un lien de média social pour la contenu.Maximum de trois par contenu.Le nom de l'objet peut être n'importe lequel de :

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Pour la syntaxe, voir la demande d'échantillon sous Mise à jour des ressources .

state string

Si la ressource est active ou archivée. Non spécifié n'est pas utilisé.

AssetVersion

Une version de ressource.

Attributs

creationContext object

Le contexte de création qui n'est pas partie du contenu des ressources, comme les métadonnées et les informations sur le créateur. Nécessaire pour créer une ressource.

moderationResult object

Le résultat de modération de la contenu.

path string

Le chemin de ressource retourné de la version de l'actif. Format : assets/{assetId}/versions/{version} . Exemple : assets/2205400862/versions/1 .

CreationContext

Le contexte de création qui n'est pas partie du contenu des ressources, comme les métadonnées et les informations sur le créateur. Nécessaire pour créer une ressource.

Attributs

creator object

Représente un créateur.

Requis
expectedPrice number

Taxe de téléchargement des ressources attendue en Robux. Lorsque le prix réel est supérieur à ce qui était prévu, l'opération échoue avec une erreur 400.

Creator

Représente un créateur.

Attributs

groupId number

L'ID de groupe. Requis si la ressource appartient à un groupe.

userId number

L'ID utilisateur du créateur. Nécessaire si la ressource est détenue par un utilisateur individuel.

ModerationResult

Le résultat de modération de la contenu.

Attributs

moderationState string

L'état de modération de la contenu. Peut être Reviewing , Rejected ou Approved .

Operation

Cette ressource représente une opération de longue durée qui est le résultat d'un appel de réseau API.

Attributs

done boolean

Si false , l'opération est toujours en cours. Si true , l'opération est terminée.

error object

Le modèle d'erreur logique expliquant l'statutd'erreur.

metadata object

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

path string

Le chemin de ressource attribué par le serveur. Le format par défaut est operations/{operation_id} .

response object

Contient un message sérialisé arbitraire ainsi qu'un @type qui décrit le type du message sérialisé.

Preview

Aperçu d'une ressource.

Attributs

altText string

Texte alternatif pour la ressource en contenu.

asset string

Le chemin de prévisualisation des ressources.

Un lien de média social pour la contenu.Maximum de trois par contenu.Le nom de l'objet peut être n'importe lequel de :

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink >
  • twitchSocialLink >
  • discordSocialLink >
  • githubSocialLink >
  • robloxSocialLink >
  • guildedSocialLink >
  • devForumSocialLink >
  • >
Pour la syntaxe, voir la demande d'échantillon sous Mise à jour des ressources .

Attributs

title string

Un titre facultatif pour le lien des médias sociaux. Ne pas l'utiliser sur le hub des créateurs.

uri string

L' URI pour le lierdes médias sociaux.Doit correspondre au format attendu pour le type de lier.Par exemple, le titre d'un objet twitchSocialLink doit être du format https://twitch.tv/your-channel.

State

Si la ressource est active ou archivée. Non spécifié n'est pas utilisé.

Attributs

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

Status

Le modèle d'erreur logique expliquant l'statutd'erreur.

Attributs

code number

Le code d'état HTTP.

details array<object>

Une liste de messages portant des détails d'erreur.

message string

Le message d'erreur.