標準資料存取

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

Datastores

https://apis.roblox.com/datastores

根據相對基本網址的路徑，可使用下列終點。

列存資料存取

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

參數

universeId number

Path

需要

cursor string

limit number

prefix string

請求

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"

回應

200 - OK

傳回： 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

需要權限

列出資料庫

Entries

https://apis.roblox.com/datastores

根據相對基本網址的路徑，可使用下列終點。

列出項目

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

參數

universeId number

Path

需要

datastoreName string

scope string

allScopes boolean

prefix string

cursor string

limit number

請求

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"

回應

200 - OK

傳回： object

application/json

{
  "keys": [
    {
      "key": "269323"
    }
  ],
  "nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"
}

keys array<string>

nextPageCursor string

需要權限

列出條目鍵

取得入口

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

參數

universeId number

Path

需要

datastoreName string

entryKey string

scope string

請求

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"

回應

200 - OK

返回資料體內的使用者內容。

傳回： 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

204 - No Content

需要權限

讀取條目

設定入口

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

參數

universeId number

Path

需要

datastoreName string

entryKey string

matchVersion string

exclusiveCreate boolean

scope string

roblox-entry-attributes string

Header

roblox-entry-userids string

Header

content-md5 string

Header

請求

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"

回應

200 - OK

傳回： object

version string

deleted boolean

contentLength number

createdTime string

objectCreatedTime string

需要權限

建立條目
更新條目

刪除項目

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

參數

universeId number

Path

需要

datastoreName string

entryKey string

scope string

請求

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"

回應

204 - No Content

需要權限

刪除條目

增量輸入

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

參數

universeId number

Path

需要

datastoreName string

entryKey string

incrementBy number

scope string

roblox-entry-attributes string

Header

roblox-entry-userids string

Header

請求

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"

回應

200 - OK

返回增加後的最新版本。

傳回： 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

204 - No Content

需要權限

建立條目
更新條目

取得入口版本

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

參數

universeId number

Path

需要

datastoreName string

entryKey string

versionId string

scope string

請求

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"

回應

200 - OK

傳回： 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

需要權限

讀取版本

限制

每個 API 金鑰：每個 IP 位址每 60 秒 100 個請求

列出入版本

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

參數

universeId number

Path

需要

datastoreName string

entryKey string

scope string

cursor string

startTime string

endTime string

sortOrder string

limit number

請求

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"

回應

200 - OK

傳回： object

version string

deleted boolean

contentLength number

createdTime string

objectCreatedTime string

其他狀態碼

需要權限

列出版本

物件

以下物件描述被接受或退回的負載。若要獲得更多關於物件使用時機的資訊，請查看個別終點。

DataStore

特性

name string

createdTime string

EntryVersion

特性

version string

deleted boolean

contentLength number

createdTime string

objectCreatedTime string