Stockage de données standard
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Cette page inclut une documentation de référence pour travailler avec des magasins de données standard.Pour plus d'informations sur l'utilisation de l'API, voir gérer les demandes d'API pour les magasins de données et le guide d'utilisation.
Datastores
Les points de terminaison suivants sont disponibles à des chemins relatifs à l'URL de base.
Liste des magasins de données
Renvoie une liste des magasins de données d'une expérience.
Paramètres
L'identifiant de l'expérience avec des magasins de données auxquels vous souhaitez accès.Vous pouvez copier l'ID de l'univers de votre expérience sur le tableau de bord du créateur .
Fournir pour demander la prochaine série de données. Voir curseurs .
Le nombre maximum d'éléments à renvoyer.Chaque appel ne lit qu'une seule partition, il peut donc retourner moins de la valeur donnée lorsqu'il n'a plus d'objectifs sur une seule partition.
Fournir pour retourner uniquement des magasins de données avec ce préfixe.
Requête
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "prefix=Player" \
-d "limit=5"
Réponse
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).
Entries
Les points de terminaison suivants sont disponibles à des chemins relatifs à l'URL de base.
Liste des entrées
Renvoie une liste de clés d'entrée dans un boutiquede données.
Paramètres
L'identifiant de l'expérience avec des magasins de données auxquels vous souhaitez accès.Vous pouvez copier l'ID de l'univers de votre expérience sur le tableau de bord du créateur .
Le nom du boutiquede données.
La valeur est global par défaut. Voir domaines .
Définir sur vrai pour retourner des clés de tous les scopes.
Fournir pour retourner uniquement des clés avec ce préfixe.
Fournir pour demander la prochaine série de données. Voir curseurs .
Le nombre maximum d'éléments à renvoyer.Chaque appel ne lit qu'une seule partition, il peut donc retourner moins de la valeur donnée lorsqu'il n'a plus d'objectifs sur une seule partition.
Requête
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "prefix=" \
-d "limit=5"
Réponse
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).
Obtenir une entrée
Renvoie la valeur et les métadonnées associées à une entrée.
Les métadonnées peuvent être trouvées dans les en-têtes de réponse comme le suivre:
content-md5: zuYxEhwuySMv0i8CitXImw==roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-attributes: { "myAttribute": "myValue" }roblox-entry-userids: [1, 2, 3]
| En-tête | Description | |---|---| | content-md5 | Le somme de contrôle MD5 codé en base-64 du contenu.Voir Contenu-MD5 .| | roblox-entry-version | La version de l'entrée retournée.| | roblox-entry-created-time | L'heure à laquelle l'entrée a été créée.| | roblox-entry-version-created-time | L'heure à laquelle cette version spécifique a été créée.| | roblox-entry-attributes | Attributes étiquetés avec l'entrée.objetde carte JSON sérialisé.| | roblox-entry-userids | Liste séparée par des virgules des ID d'utilisateur Roblox étiquetés avec l'entrée. |
Paramètres
L'identifiant de l'expérience avec des magasins de données auxquels vous souhaitez accès.Vous pouvez copier l'ID de l'univers de votre expérience sur le tableau de bord du créateur .
Le nom du boutiquede données.
La clé qui identifie l'entrée.
La valeur est global par défaut. Voir domaines .
Requête
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323"
Réponse
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).
Définir l'entrée
Définit la valeur, les métadonnées et les identifiants d'utilisateur associés à une entrée.
Paramètres
L'identifiant de l'expérience avec des magasins de données auxquels vous souhaitez accès.Vous pouvez copier l'ID de l'univers de votre expérience sur le tableau de bord du créateur .
Le nom du boutiquede données.
La clé qui identifie l'entrée.
Fournir à mettre à jour seulement si la version actuelle correspond à ceci.
Créez l'entrée seulement si elle n'existe pas.
La valeur est global par défaut. Voir domaines .
Attributs à associer à la nouvelle version de l'entrée. Sérialisés par des objets de carte JSON. S'ils ne sont pas fournis, les attributs existants sont effacés.
Liste séparée par des virgules des ID d'utilisateur Roblox étiquetés avec l'entrée. S'ils ne sont pas fournis, les ID d'utilisateur existants sont effacés.
Le somme de contrôle MD5 encodé en base-64 du contenu. Voir Contenu-MD5 .
Requête
curl --include --location --request POST "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry?datastoreName=Coins&entryKey=269323" \
--header "x-api-key: ${API_KEY}" \
--header "content-md5: IGPBYI1uC6+AJJxC4r5YBA==" \
--header "content-type: application/json" \
--header "roblox-entry-userids: [269323]" \
--header "roblox-entry-attributes: {}" \
--d "value"
Réponse
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).
Supprimer l'entrée
Marque l'entrée comme supprimée en créant une version de tombeau. Les entrées sont supprimées définitivement après 30 jours.
Paramètres
L'identifiant de l'expérience avec des magasins de données auxquels vous souhaitez accès.Vous pouvez copier l'ID de l'univers de votre expérience sur le tableau de bord du créateur .
Le nom du boutiquede données.
La clé qui identifie l'entrée.
La valeur est global par défaut. Voir domaines .
Requête
curl --include --location --request DELETE "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323"
Réponse
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).
Entrée d'augmentation
Augmente la valeur d'une entrée d'un montant donné, ou crée une nouvelle entrée avec ce montant. Renvoie l'entrée et les métadonnées.
Les métadonnées peuvent être trouvées dans les en-têtes de réponse comme le suivre:
content-md5: zuYxEhwuySMv0i8CitXImw==roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-attributes: { "myAttribute": "myValue" }roblox-entry-userids: [1, 2, 3]
| En-tête | Description | |---|---| | content-md5 | Le somme de contrôle MD5 codé en base-64 du contenu.Voir Contenu-MD5 .| | roblox-entry-version | La version de l'entrée retournée.| | roblox-entry-created-time | L'heure à laquelle l'entrée a été créée.| | roblox-entry-version-created-time | L'heure à laquelle cette version spécifique a été créée.| | roblox-entry-attributes | Attributes étiquetés avec l'entrée.objetde carte JSON sérialisé.| | roblox-entry-userids | Liste séparée par des virgules des ID d'utilisateur Roblox étiquetés avec l'entrée. |
Paramètres
L'identifiant de l'expérience avec des magasins de données auxquels vous souhaitez accès.Vous pouvez copier l'ID de l'univers de votre expérience sur le tableau de bord du créateur .
Le nom du boutiquede données.
La clé qui identifie l'entrée.
Le montant par lequel l'entrée doit être augmentée, ou la valeur de départ si elle n'existe pas.
La valeur est global par défaut. Voir domaines .
Attributs à associer à la nouvelle version de l'entrée. Sérialisés par des objets de carte JSON. S'ils ne sont pas fournis, les attributs existants sont effacés.
Une liste séparée par des virgules des ID d'utilisateur Roblox avec lesquels l'entrée est étiquetée. S'il n'est pas fourni, les ID d'utilisateur existants sont effacés.
Requête
curl --include --location --request POST "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/increment" \
--header "x-api-key: ${API_KEY}" \
--header 'content-length: 0' \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323" \
-d "incrementBy=3"
Réponse
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).
Obtenir la version d'entrée
Renvoie la valeur et les métadonnées d'une version spécifique d'une entrée.
Les métadonnées peuvent être trouvées dans les en-têtes de réponse comme le suivre:
content-md5: zuYxEhwuySMv0i8CitXImw==roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00roblox-entry-attributes: { "myAttribute": "myValue" }roblox-entry-userids: [1, 2, 3]
| En-tête | Description | |---|---| | content-md5 | Le somme de contrôle MD5 codé en base-64 du contenu.Voir Contenu-MD5 .| | roblox-entry-version | La version de l'entrée retournée.| | roblox-entry-created-time | L'heure à laquelle l'entrée a été créée.| | roblox-entry-version-created-time | L'heure à laquelle cette version spécifique a été créée.| | roblox-entry-attributes | Attributes étiquetés avec l'entrée.objetde carte JSON sérialisé.| | roblox-entry-userids | Liste séparée par des virgules des ID d'utilisateur Roblox étiquetés avec l'entrée. |
Paramètres
L'identifiant de l'expérience avec des magasins de données auxquels vous souhaitez accès.Vous pouvez copier l'ID de l'univers de votre expérience sur le tableau de bord du créateur .
Le nom du boutiquede données.
La clé qui identifie l'entrée.
La version à inspecter.
La valeur est global par défaut. Voir domaines .
Requête
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/versions/version" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323" \
-d "versionId=08D9E6A3F2188CFF.0000000003.08D9E6DE485A7680.01"
Réponse
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).
Limitations
Par clé API : 5000 demande toutes les 60 secondes par adresse IP
Versions d'entrée de liste
Renvoie une liste de versions pour une entrée.
Paramètres
L'identifiant de l'expérience avec des magasins de données auxquels vous souhaitez accès.Vous pouvez copier l'ID de l'univers de votre expérience sur le tableau de bord du créateur .
Le nom du boutiquede données.
La clé qui identifie l'entrée.
La valeur est global par défaut. Voir domaines .
Fournir pour demander la prochaine série de données (voir curseurs).
Fournir pour ne pas inclure de versions antérieures à cette date de timestamp.
Fournir pour ne pas inclure de versions antérieures à cette date de timestamp.
Soit Ascending (premières versions d'abord) ou Descending (versions ultérieures d'abord).
Le nombre maximum d'éléments à renvoyer.Chaque appel ne lit qu'une seule partition, il peut donc retourner moins de la valeur donnée lorsqu'il n'a plus d'objectifs sur une seule partition.
Requête
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/versions" \
--header "x-api-key: ${API_KEY}" \
--get \
-d "datastoreName=Coins" \
-d "entryKey=269323" \
-d "limit=5"
Réponse
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).
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.
DataStore
L'objet de stockage de données avec son nom et son temps de création.
Attributs
Le nom de votre boutiquede données.
L'horodatage du moment de la création du magasin de données dans le format de temps ISO.
EntryVersion
L'objet de version d'entrée retourné par la méthode List Entry Versions.
Attributs
Le nom de version de l'entrée qualifiée.
Indique si l'entrée a été supprimée.
La longueur du contenu.
L'horodatage de la création de la version dans le format de temps ISO.
L'horodatage du moment de la création du magasin de données dans le format de temps ISO.