Standard Data Stores

Datastores

https://apis.roblox.com/datastores
Les points de terminaison suivants sont disponibles à des chemins relatifs à l'URL de base.

List Data Stores

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

  • Liste des datastores

Entries

https://apis.roblox.com/datastores
Les points de terminaison suivants sont disponibles à des chemins relatifs à l'URL de base.

List Entries

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

  • Clés d'entrée de liste

Get Entry

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
Returns the user content of the entry in the body of the response.
Renvoie une object
application/json

{
"content-md5": "zuYxEhwuySMvOi8CitXImw==",
"roblox-entry-version": "08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01",
"roblox-entry-created-time": "2022-02-02T23:30:06.5388799+00:00",
"roblox-entry-version-created-time": "2022-02-02T23:30:06.5388799+00:00",
"roblox-entry-userids": [ 1, 2, 3 ]
}
roblox-entry-created-time string
last-modified string
roblox-entry-version string
roblox-entry-attributes string
roblox-entry-userids array<number>
content-md5 string

Autorisations requises

  • Lecture de l'entrée

Set Entry

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

  • Créer une entrée
  • Mettre à jour l'entrée

Delete Entry

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

  • Supprimer entrée

Increment Entry

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
Returns the latest version of the entry after it has been incremented.
Renvoie une object
application/json

{
"content-md5": "K4phWUsfTE2wkCqKOVztkw==",
"roblox-entry-version": "08D9E6A3F2188CFF.0000000009.08D9E6DF74AC5F42.01",
"roblox-entry-created-time": "2022-02-02T23:30:06.5388799+00:00",
"roblox-entry-version-created-time": "2022-02-03T06:36:05.9184962+00:00",
"roblox-entry-userids": []
}
roblox-entry-created-time string
last-modified string
roblox-entry-version string
roblox-entry-attributes string
roblox-entry-userids array<number>
content-md5 string

Autorisations requises

  • Créer une entrée
  • Mettre à jour l'entrée

Get Entry Version

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
Renvoie une object
application/json

{
"content-md5": "sTf90fedVsft8zZf6nUg8g==",
"roblox-entry-version": "08D9E6A3F2188CFF.0000000003.08D9E6DE485A7680.01",
"roblox-entry-created-time": "2022-02-02T23:30:06.5388799+00:00",
"roblox-entry-version-created-time": "2022-02-03T06:27:42.0652160+00:00",
"roblox-entry-attributes": {},
"roblox-entry-userids": [ 269323 ]
}
roblox-entry-created-time string
last-modified string
roblox-entry-version string

Autorisations requises

  • Lire la version

Limitations

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

List Entry Versions

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

  • Lister les versions

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

Attributs

name string
createdTime string

EntryVersion

Attributs

version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string