Các cửa hàng dữ liệu tiêu chuẩn

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Datastores

https://apis.roblox.com/datastores
Các điểm cuối sau đây có trong đường dẫn liên quan đến URL cơ sở.

Danh sách các tài nguyên dữ liệu

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

Tham Số

universeId number
Path
Bắt Buộc
cursor string
limit number
prefix string

Yêu Cầu

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"

Phản Hồi

200 - OK
Trả lại 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

Quyền Cần Có

  • Liệt Kê Kho Dữ Liệu

Entries

https://apis.roblox.com/datastores
Các điểm cuối sau đây có trong đường dẫn liên quan đến URL cơ sở.

Danh sách hồ sơ

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

Tham Số

universeId number
Path
Bắt Buộc
datastoreName string
scope string
allScopes boolean
prefix string
cursor string
limit number

Yêu Cầu

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"

Phản Hồi

200 - OK
Trả lại object
application/json
{

  "keys": [

    {

      "key": "269323"

    }

  ],

  "nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"

}
keys array<string>
nextPageCursor string

Quyền Cần Có

  • Liệt Kê Khóa Mục Nhập

Nhận nội dung

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

Tham Số

universeId number
Path
Bắt Buộc
datastoreName string
entryKey string
scope string

Yêu Cầu

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"

Phản Hồi

200 - OK
Trả lại nội dung người dùng của mục trong cơ thể của phản hồi.
Trả lại 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

Quyền Cần Có

  • Đọc Mục Nhập

Thiết lập nhập

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

Tham Số

universeId number
Path
Bắt Buộc
datastoreName string
entryKey string
matchVersion string
exclusiveCreate boolean
scope string
roblox-entry-attributes string
Header
roblox-entry-userids string
Header
content-md5 string
Header

Yêu Cầu

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"

Phản Hồi

200 - OK
Trả lại object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Quyền Cần Có

  • Tạo Mục Nhập
  • Cập Nhật Mục Nhập

Xóa mục

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

Tham Số

universeId number
Path
Bắt Buộc
datastoreName string
entryKey string
scope string

Yêu Cầu

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"

Phản Hồi

Quyền Cần Có

  • Xóa Mục Nhập

Tăng trưởng mục

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

Tham Số

universeId number
Path
Bắt Buộc
datastoreName string
entryKey string
incrementBy number
scope string
roblox-entry-attributes string
Header
roblox-entry-userids string
Header

Yêu Cầu

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"

Phản Hồi

200 - OK
Trả lại phiên bản mới nhất của hồ sơ sau khi nó đã được tăng.
Trả lại 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

Quyền Cần Có

  • Tạo Mục Nhập
  • Cập Nhật Mục Nhập

Nhận raPhiên bản

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

Tham Số

universeId number
Path
Bắt Buộc
datastoreName string
entryKey string
versionId string
scope string

Yêu Cầu

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"

Phản Hồi

200 - OK
Trả lại 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

Quyền Cần Có

  • Đọc Phiên Bản

Giới Hạn

Mỗi Khóa API: 100 yêu cầu mỗi 60 giây cho mỗi Địa Chỉ IP

Danh sách các phiên bản

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

Tham Số

universeId number
Path
Bắt Buộc
datastoreName string
entryKey string
scope string
cursor string
startTime string
endTime string
sortOrder string
limit number

Yêu Cầu

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"

Phản Hồi

200 - OK
Trả lại object
version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string

Quyền Cần Có

  • Liệt Kê Các Phiên Bản

Đối Tượng

Các đối tượng sau đây mô tả payload được chấp nhận hoặc bị trả về. Xem từng điểm cuối để biết thêm thông tin về thời điểm sử dụng các đối tượng này.

DataStore

Thuộc Tính

name string
createdTime string

EntryVersion

Thuộc Tính

version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string