ห้องเก็บข้อมูลมาตรฐาน

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

Datastores

https://apis.roblox.com/datastores
Endpoints ต่อไปนี้พร้อมใช้งานที่เส้นทางที่สัมพันธ์กับ URL หลัก

รายการ Data Stores

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

สิทธิ์ที่ต้องมี

  • List Datastores

Entries

https://apis.roblox.com/datastores
Endpoints ต่อไปนี้พร้อมใช้งานที่เส้นทางที่สัมพันธ์กับ URL หลัก

รายการรายการ

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

สิทธิ์ที่ต้องมี

  • List Entry Keys

รับการเข้าถึง

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

สิทธิ์ที่ต้องมี

  • Read Entry

การตั้งค่าการเข้าถึง

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

สิทธิ์ที่ต้องมี

  • Create Entry
  • Update Entry

ลบรายการ

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"

การตอบกลับ

สิทธิ์ที่ต้องมี

  • Delete Entry

เพิ่มข้อมูลที่นี่

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

สิทธิ์ที่ต้องมี

  • Create Entry
  • Update Entry

รับรุ่นการเข้าถึง

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

สิทธิ์ที่ต้องมี

  • Read Version

การจำกัด

ต่อคีย์ API: 100 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP

รายการเวอร์ชันการเข้าถึง

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

สิทธิ์ที่ต้องมี

  • List Versions

วัตถุ

วัตถุต่อไปนี้ใช้บรรยายเพย์โหลดที่ยอมรับหรือส่งคืน ดูข้อมูลเพิ่มเติมว่าจะใช้วัตถุเหล่านี้ตอนไหนที่ Endpoint แต่ละจุด

DataStore

คุณลักษณะ

name string
createdTime string

EntryVersion

คุณลักษณะ

version string
deleted boolean
contentLength number
createdTime string
objectCreatedTime string