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

204 - No Content

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

204 - No Content

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

204 - No Content

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

Autres codes de statut

Autorisations requises

Objets

DataStore

Attributs

name string

createdTime string

EntryVersion

Attributs

version string

deleted boolean

contentLength number

createdTime string

objectCreatedTime string