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.

Datastores

https://apis.roblox.com/datastores

Liste des magasins de données

GET /v1/universes/{universeId}/standard-datastores

Paramètres

universeId number
Path
Requis
cursor string
limit number
prefix string

Requête

curl

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

200 - OK
Renvoie une object
application/json

{
"datastores": [
{
"name": "PlayerInventory",
"createdTime": "2022-02-18T22:38:59.9244932Z"
},
{
"name": "PlayerExperience",
"createdTime": "2022-02-18T23:00:10.4773508Z"
},
{
"name": "PlayerWeapons",
"createdTime": "2022-02-18T23:00:22.3725681Z"
},
{
"name": "PlayerArmor",
"createdTime": "2022-02-18T22:59:33.8472882Z"
},
{
"name": "PlayerHP",
"createdTime": "2022-02-18T22:58:47.6904028Z"
}
],
"nextPageCursor": "..."
}
data array<object>
nextPageCursor string

Autorisations requises

Entries

https://apis.roblox.com/datastores

Liste des entrées

GET /v1/universes/{universeId}/standard-datastores/datastore/entries

Paramètres

universeId number
Path
Requis
datastoreName string
scope string
allScopes boolean
prefix string
cursor string
limit number

Requête

curl

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

200 - OK
Renvoie une object
application/json

{
"keys": [
{
"key": "269323"
}
],
"nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"
}
keys array<string>
nextPageCursor string

Autorisations requises

Obtenir une entrée

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

Paramètres

universeId number
Path
Requis
datastoreName string
entryKey string
scope string

Requête

curl

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

200 - OK
Récupération de l'entrée réussie.
Renvoie une object

Autorisations requises

Définir l'entrée

POST /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

Paramètres

universeId number
Path
Requis
datastoreName string
entryKey string
matchVersion string
exclusiveCreate boolean
scope string
roblox-entry-attributes string
Header
roblox-entry-userids string
Header
content-md5 string
Header

Requête

curl

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

200 - OK
Renvoie une object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Autorisations requises

Supprimer l'entrée

DELETE /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

Paramètres

universeId number
Path
Requis
datastoreName string
entryKey string
scope string

Requête

curl

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

Entrée d'augmentation

POST /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/increment

Paramètres

universeId number
Path
Requis
datastoreName string
entryKey string
incrementBy number
scope string
roblox-entry-attributes string
Header
roblox-entry-userids string
Header

Requête

curl

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

200 - OK
Renvoie la dernière version de l'entrée après qu'elle ait été augmentée.
Renvoie une object

Autorisations requises

Obtenir la version d'entrée

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/versions/version

Paramètres

universeId number
Path
Requis
datastoreName string
entryKey string
versionId string
scope string

Requête

curl

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

200 - OK
Récupération de l'entrée réussie.
Renvoie une object

Autorisations requises

Limitations

Versions d'entrée de liste

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/versions

Paramètres

universeId number
Path
Requis
datastoreName string
entryKey string
scope string
cursor string
startTime string
endTime string
sortOrder string
limit number

Requête

curl

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

200 - OK
Renvoie une object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Autorisations requises

Objets

DataStore

Attributs

name string
createdTime string

EntryVersion

Attributs

version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string