Store di dati standard

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Datastores

https://apis.roblox.com/datastores
I seguenti endpoint sono disponibili nei percorsi relativi all'URL di base.

Elenca Negozi di Dati

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

Parametri

universeId number
Path
Necessario
cursor string
limit number
prefix string

Richiesta

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"

Risposta

200 - OK
Ritorna un(a) 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

Permessi Necessari

  • Elenca i datastore

Entries

https://apis.roblox.com/datastores
I seguenti endpoint sono disponibili nei percorsi relativi all'URL di base.

Elenco delle voci

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

Parametri

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

Richiesta

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"

Risposta

200 - OK
Ritorna un(a) object
application/json
{

  "keys": [

    {

      "key": "269323"

    }

  ],

  "nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"

}
keys array<string>
nextPageCursor string

Permessi Necessari

  • Elenco chiavi di accesso

Ottieni l'ingresso

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

Parametri

universeId number
Path
Necessario
datastoreName string
entryKey string
scope string

Richiesta

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"

Risposta

200 - OK
Restituisce il contenuto utente dell'elemento nel corpo della risposta.
Ritorna un(a) 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

Permessi Necessari

  • Leggi elemento

Imposta entrata

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

Parametri

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

Richiesta

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"

Risposta

200 - OK
Ritorna un(a) object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Permessi Necessari

  • Crea elemento
  • Aggiorna elemento

Elimina elemento

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

Parametri

universeId number
Path
Necessario
datastoreName string
entryKey string
scope string

Richiesta

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"

Risposta

Permessi Necessari

  • Elimina voce

Incrementa l'ingresso

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

Parametri

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

Richiesta

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"

Risposta

200 - OK
Restituisce la versione più recente dell'elemento dopo che è stata incrementata.
Ritorna un(a) 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

Permessi Necessari

  • Crea elemento
  • Aggiorna elemento

Ottieni la versione di ingresso

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

Parametri

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

Richiesta

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"

Risposta

200 - OK
Ritorna un(a) 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

Permessi Necessari

  • Leggi versione

Limiti

Per chiave API: 100 richieste ogni 60 secondi per indirizzo IP

Versioni dell'elemento di lista

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

Parametri

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

Richiesta

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"

Risposta

200 - OK
Ritorna un(a) object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Permessi Necessari

  • Elenca versioni

Oggetti

Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.

DataStore

Attributi

name string
createdTime string

EntryVersion

Attributi

version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string