Almacenes de datos estándar

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

Datastores

https://apis.roblox.com/datastores

Almacenes de datos de lista

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

Parámetros

universeId number
Path
Obligatorio
cursor string
limit number
prefix string

Solicitud

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"

Respuesta

200 - OK
Devuelve 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

Permisos obligatorios

Entries

https://apis.roblox.com/datastores

Listar entradas

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

Parámetros

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

Solicitud

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"

Respuesta

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

  "keys": [

    {

      "key": "269323"

    }

  ],

  "nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"

}
keys array<string>
nextPageCursor string

Permisos obligatorios

Obtener entrada

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

Parámetros

universeId number
Path
Obligatorio
datastoreName string
entryKey string
scope string

Solicitud

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"

Respuesta

200 - OK
Recuperado con éxito la entrada.
Devuelve un(a) object

Permisos obligatorios

Establecer entrada

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

Parámetros

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

Solicitud

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"

Respuesta

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

Permisos obligatorios

Eliminar entrada

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

Parámetros

universeId number
Path
Obligatorio
datastoreName string
entryKey string
scope string

Solicitud

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"

Respuesta

Permisos obligatorios

Entrada de incremento

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

Parámetros

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

Solicitud

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"

Respuesta

200 - OK
Devuelve la última versión de la entrada después de que se haya incrementado.
Devuelve un(a) object

Permisos obligatorios

Obtener la versión de entrada

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

Parámetros

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

Solicitud

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"

Respuesta

200 - OK
Recuperado con éxito la entrada.
Devuelve un(a) object

Permisos obligatorios

Límites

Versiones de entrada de lista

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

Parámetros

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

Solicitud

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"

Respuesta

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

Permisos obligatorios

Objetos

DataStore

Atributos

name string
createdTime string

EntryVersion

Atributos

version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string