Standard-Datenspeicher

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Datastores

https://apis.roblox.com/datastores
Die folgenden Endpunkte sind bei Pfaden relativ zur Basis-URL verfügbar.

Listen-Datenspeicher

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

Parameter

universeId number
Path
Erforderlich
cursor string
limit number
prefix string

Anfrage

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

200 - OK
Gibt zurück ein(e) 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

Erforderliche Berechtigungen

  • Datenspeicher auflisten

Entries

https://apis.roblox.com/datastores
Die folgenden Endpunkte sind bei Pfaden relativ zur Basis-URL verfügbar.

Listen-Einträge

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

Parameter

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

Anfrage

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

200 - OK
Gibt zurück ein(e) object
application/json
{

  "keys": [

    {

      "key": "269323"

    }

  ],

  "nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"

}
keys array<string>
nextPageCursor string

Erforderliche Berechtigungen

  • Listeneintragschlüssel

Eintrag holen

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

Parameter

universeId number
Path
Erforderlich
datastoreName string
entryKey string
scope string

Anfrage

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

200 - OK
Kehrt den Inhalt des Benutzers der Einreichung in den Körper der Antwort zurück.
Gibt zurück ein(e) 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

Erforderliche Berechtigungen

  • Eintrag lesen

Eintrag einrichten

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

Parameter

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

Anfrage

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

200 - OK
Gibt zurück ein(e) object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Erforderliche Berechtigungen

  • Eintrag erstellen
  • Eintrag aktualisieren

Eintrag löschen

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

Parameter

universeId number
Path
Erforderlich
datastoreName string
entryKey string
scope string

Anfrage

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

Erforderliche Berechtigungen

  • Eintrag löschen

Einkommens-Erhöhung

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

Parameter

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

Anfrage

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

200 - OK
Kehrt die neueste Version des Eintrags zurück, nachdem er incrementiert wurde.
Gibt zurück ein(e) 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

Erforderliche Berechtigungen

  • Eintrag erstellen
  • Eintrag aktualisieren

Eintrag-Version abrufen

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

Parameter

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

Anfrage

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

200 - OK
Gibt zurück ein(e) 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

Erforderliche Berechtigungen

  • Version lesen

Limits

Pro API-Schlüssel: 100 Anfoderungen pro 60 Sekunden pro IP-Adresse

Listen-Eintrag-Versionen

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

Parameter

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

Anfrage

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

200 - OK
Gibt zurück ein(e) object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Erforderliche Berechtigungen

  • Versionen auflisten

Objekte

Die folgenden Objekte beschreiben Nutzlasten, die akzeptiert oder zurückgegeben werden. Die einzelnen Endpunkte zeigen weitere Informationen darüber an, wann diese Objekte verwendet werden.

DataStore

Attribute

name string
createdTime string

EntryVersion

Attribute

version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string