Standart Veri Depoları

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Datastores

https://apis.roblox.com/datastores
Şu uç noktaları, taban URL'ye göre belirlenen yollarda mevcut.

Veri Depoları Listesi

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

Parametreler

universeId number
Path
Gerekli
cursor string
limit number
prefix string

Talep

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"

Yanıt

200 - OK
Şunu döndürür: 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

Gerekli İzinler

  • List Datastores

Entries

https://apis.roblox.com/datastores
Şu uç noktaları, taban URL'ye göre belirlenen yollarda mevcut.

Girişleri Listele

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

Parametreler

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

Talep

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"

Yanıt

200 - OK
Şunu döndürür: object
application/json
{

  "keys": [

    {

      "key": "269323"

    }

  ],

  "nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"

}
keys array<string>
nextPageCursor string

Gerekli İzinler

  • List Entry Keys

Girişi Al

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

Parametreler

universeId number
Path
Gerekli
datastoreName string
entryKey string
scope string

Talep

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"

Yanıt

200 - OK
Yanıtın vücudundaki girişin kullanıcı içeriğini iade eder.
Şunu döndürür: 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

Gerekli İzinler

  • Read Entry

Girişi Ayarla

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

Parametreler

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

Talep

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"

Yanıt

200 - OK
Şunu döndürür: object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Gerekli İzinler

  • Create Entry
  • Update Entry

Girişi Sil

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

Parametreler

universeId number
Path
Gerekli
datastoreName string
entryKey string
scope string

Talep

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"

Yanıt

Gerekli İzinler

  • Delete Entry

Girişi Artır

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

Parametreler

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

Talep

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"

Yanıt

200 - OK
Girişin artırıldıktan sonra girişin en son versiyonunu iade eder.
Şunu döndürür: 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

Gerekli İzinler

  • Create Entry
  • Update Entry

Giriş Sürümünü Al

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

Parametreler

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

Talep

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"

Yanıt

200 - OK
Şunu döndürür: 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

Gerekli İzinler

  • Read Version

Sınırlar

API Anahtarı başına: Her 60 saniyede IP adresi başına 100 talep

Giriş Versiyonlarını Listele

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

Parametreler

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

Talep

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"

Yanıt

200 - OK
Şunu döndürür: object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Gerekli İzinler

  • List Versions

Nesneler

Şu nesneler kabul edilen veya döndürülen yükleri tanımlar. Bu nesnelerin ne zaman kullanıldığı hakkında daha fazla bilgi için tüm uç noktalara bak.

DataStore

Nitelikler

name string
createdTime string

EntryVersion

Nitelikler

version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string