Stockages 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
Les points de terminaison suivants sont disponibles à des chemins relatifs à l'URL de base.

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

  • Liste des datastores

Entries

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

Rechercher 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

  • Clés d'entrée de liste

Obtenir l'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
Renvoie le contenu de l'utilisateur de l'entrée dans le corps de la réponse.
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

Entrée de

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

Supprimer 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

  • Supprimer entrée

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

Obtenez la version de l'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
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

Version de la 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

  • 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