ร้านข้อมูลมาตรฐาน

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

หน้านี้รวมถึงเอกสารอ้างอิงสำหรับการทำงานกับร้านข้อมูลมาตรฐานสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ API ดู จัดการคำขอ API สำหรับร้านข้อมูล และคู่มือการใช้งาน

Datastores

https://apis.roblox.com/datastores

Endpoints ต่อไปนี้พร้อมใช้งานที่เส้นทางที่สัมพันธ์กับ URL หลัก

รายการเก็บข้อมูล

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

คืนรายการของไซต์เก็บข้อมูลประสบการณ์

พารามิเตอร์

universeId number

ตัวระบุของประสบการณ์ที่มีร้านข้อมูลที่คุณต้องการเข้าถึงคุณสามารถ คัดลอก ID จักรวาลของประสบการณ์ของคุณ บน แดชบอร์ดของผู้สร้าง

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

ตั้งค่าดู เคอร์เซอร์ .

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

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

  • List Datastores

Entries

https://apis.roblox.com/datastores

Endpoints ต่อไปนี้พร้อมใช้งานที่เส้นทางที่สัมพันธ์กับ URL หลัก

รายการเข้าร่วม

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

ร้านค้า

พารามิเตอร์

universeId number

ตัวระบุของประสบการณ์ที่มีร้านข้อมูลที่คุณต้องการเข้าถึงคุณสามารถ คัดลอก ID จักรวาลของประสบการณ์ของคุณ บน แดชบอร์ดของผู้สร้าง

Path
จำเป็นต้องมี
datastoreName string

ร้านค้า

scope string

ค่าเริ่มต้นคือ global โดยเริ่มต้น ดู ขอบเขต

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

ตั้งค่าดู เคอร์เซอร์ .

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

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

  • List Entry Keys

รับเอกสารเข้า

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

คืนค่าและเมทาดาตาที่เกี่ยวข้องกับรายการ

กำลังติดตาม:

content-md5: zuYxEhwuySMv0i8CitXImw==

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-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| หัวข้อ | คําอธิบาย | |---|---| | content-md5 | สรุปการตรวจสอบ MD5 ของเนื้อหาที่เข้ารหัสเป็น base-64ดู เนื้อหา-MD5| | roblox-entry-version | เวอร์ชันของรายการที่ส่งคืน| | roblox-entry-created-time | เวลาที่เข้าถูกสร้างขึ้น| | roblox-entry-version-created-time | เวลาที่รุ่นพิเศษนี้ถูกสร้างขึ้น| | roblox-entry-attributes | คุณลักษณะที่ถูกติดตามด้วยเอนทรีวัตถุแผนที่ JSON แบบเรียงลําดับ| | roblox-entry-userids | รายการแยกกับจุลภาคของ ID ผู้ใช้ Roblox ที่มีแท็กเข้ากับบันทึก |

พารามิเตอร์

universeId number

ตัวระบุของประสบการณ์ที่มีร้านข้อมูลที่คุณต้องการเข้าถึงคุณสามารถ คัดลอก ID จักรวาลของประสบการณ์ของคุณ บน แดชบอร์ดของผู้สร้าง

Path
จำเป็นต้องมี
datastoreName string

ร้านค้า

entryKey string

กุญแจที่ระบุเอาต์พุต

scope string

ค่าเริ่มต้นคือ global โดยเริ่มต้น ดู ขอบเขต

คำขอ

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

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

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

  • Read Entry

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

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

ตั้งค่าค่า、เมทาดาตาและรหัสผู้ใช้ที่เกี่ยวข้องกับรายการ

พารามิเตอร์

universeId number

ตัวระบุของประสบการณ์ที่มีร้านข้อมูลที่คุณต้องการเข้าถึงคุณสามารถ คัดลอก ID จักรวาลของประสบการณ์ของคุณ บน แดชบอร์ดของผู้สร้าง

Path
จำเป็นต้องมี
datastoreName string

ร้านค้า

entryKey string

กุญแจที่ระบุเอาต์พุต

matchVersion string

ให้อัปเดตเฉพาะเมื่อเวอร์ชันปัจจุบันตรงกับนี้

exclusiveCreate boolean

สร้างบันทึกเฉพาะถ้ามันไม่มีอยู่

scope string

ค่าเริ่มต้นคือ global โดยเริ่มต้น ดู ขอบเขต

roblox-entry-attributes string

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

Header
roblox-entry-userids string

รายการแยกกับจุลภาคของ ID ผู้ใช้ Roblox ที่มีแท็กเข้ากับรายการ หากไม่ได้ระบุ รายการผู้ใช้ที่มีอยู่จะถูกล้าง

Header
content-md5 string

เช็คสรุป MD5 ของเนื้อหาที่เข้ารหัสเป็น base-64 ดู เนื้อหา-MD5

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

เวลาที่สร้างรุ่นในรูปแบบเวลาของ ISO เมื่อสร้างรุ่น

objectCreatedTime string

เวลาที่เก็บข้อมูลถูกสร้างในรูปแบบเวลา ISO

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

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

  • Create Entry

  • Update Entry

ลบบันทึก

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

ทําเครื่องหมายการเข้าสู่ระบบว่าถูกลบโดยการสร้างรุ่นหลุมฝังศพ รายการจะถูกลบอย่างถาวรหลังจาก 30 วัน

พารามิเตอร์

universeId number

ตัวระบุของประสบการณ์ที่มีร้านข้อมูลที่คุณต้องการเข้าถึงคุณสามารถ คัดลอก ID จักรวาลของประสบการณ์ของคุณ บน แดชบอร์ดของผู้สร้าง

Path
จำเป็นต้องมี
datastoreName string

ร้านค้า

entryKey string

กุญแจที่ระบุเอาต์พุต

scope string

ค่าเริ่มต้นคือ global โดยเริ่มต้น ดู ขอบเขต

คำขอ

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"

การตอบกลับ

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

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

  • Delete Entry

บันทึกเพิ่มเติม

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

เพิ่มมูลค่าสำหรับรายการโดยจํานวนที่กำหนดหรือสร้างรายการใหม่ด้วยจํานวนนั้น คืนค่ารายการและเมทริกซ์ข้อมูล

กำลังติดตาม:

content-md5: zuYxEhwuySMv0i8CitXImw==

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-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| หัวข้อ | คําอธิบาย | |---|---| | content-md5 | สรุปการตรวจสอบ MD5 ของเนื้อหาที่เข้ารหัสเป็น base-64ดู เนื้อหา-MD5| | roblox-entry-version | เวอร์ชันของรายการที่ส่งคืน| | roblox-entry-created-time | เวลาที่เข้าถูกสร้างขึ้น| | roblox-entry-version-created-time | เวลาที่รุ่นพิเศษนี้ถูกสร้างขึ้น| | roblox-entry-attributes | คุณลักษณะที่ถูกติดตามด้วยเอนทรีวัตถุแผนที่ JSON แบบเรียงลําดับ| | roblox-entry-userids | รายการแยกกับจุลภาคของ ID ผู้ใช้ Roblox ที่มีแท็กเข้ากับบันทึก |

พารามิเตอร์

universeId number

ตัวระบุของประสบการณ์ที่มีร้านข้อมูลที่คุณต้องการเข้าถึงคุณสามารถ คัดลอก ID จักรวาลของประสบการณ์ของคุณ บน แดชบอร์ดของผู้สร้าง

Path
จำเป็นต้องมี
datastoreName string

ร้านค้า

entryKey string

กุญแจที่ระบุเอาต์พุต

incrementBy number

จำนวนที่ต้องเพิ่มเข้าไปในรายการหรือมูลค่าเริ่มต้นหากไม่มีอยู่

scope string

ค่าเริ่มต้นคือ global โดยเริ่มต้น ดู ขอบเขต

roblox-entry-attributes string

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

Header
roblox-entry-userids string

รายการแยกกับจุลภาคของ ID ผู้ใช้ Roblox ที่เข้าสู่ระบบถูกแท็ก หากไม่ได้ระบุ จะล้าง ID ผู้ใช้ที่มีอยู่

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

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

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

  • Create Entry

  • Update Entry

รับรุ่นเข้าสู่ระบบ

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

คืนค่าและเมทาดาต้าของรุ่นเฉพาะของบันทึกเข้า

กำลังติดตาม:

content-md5: zuYxEhwuySMv0i8CitXImw==

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-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| หัวข้อ | คําอธิบาย | |---|---| | content-md5 | สรุปการตรวจสอบ MD5 ของเนื้อหาที่เข้ารหัสเป็น base-64ดู เนื้อหา-MD5| | roblox-entry-version | เวอร์ชันของรายการที่ส่งคืน| | roblox-entry-created-time | เวลาที่เข้าถูกสร้างขึ้น| | roblox-entry-version-created-time | เวลาที่รุ่นพิเศษนี้ถูกสร้างขึ้น| | roblox-entry-attributes | คุณลักษณะที่ถูกติดตามด้วยเอนทรีวัตถุแผนที่ JSON แบบเรียงลําดับ| | roblox-entry-userids | รายการแยกกับจุลภาคของ ID ผู้ใช้ Roblox ที่มีแท็กเข้ากับบันทึก |

พารามิเตอร์

universeId number

ตัวระบุของประสบการณ์ที่มีร้านข้อมูลที่คุณต้องการเข้าถึงคุณสามารถ คัดลอก ID จักรวาลของประสบการณ์ของคุณ บน แดชบอร์ดของผู้สร้าง

Path
จำเป็นต้องมี
datastoreName string

ร้านค้า

entryKey string

กุญแจที่ระบุเอาต์พุต

versionId string

รุ่นที่จะตรวจสอบ

scope string

ค่าเริ่มต้นคือ global โดยเริ่มต้น ดู ขอบเขต

คำขอ

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

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

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

  • Read Version

การจำกัด

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

รายการเวอร์ชันเอนทรี

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

คืนรายการเวอร์ชันสำหรับรายการ

พารามิเตอร์

universeId number

ตัวระบุของประสบการณ์ที่มีร้านข้อมูลที่คุณต้องการเข้าถึงคุณสามารถ คัดลอก ID จักรวาลของประสบการณ์ของคุณ บน แดชบอร์ดของผู้สร้าง

Path
จำเป็นต้องมี
datastoreName string

ร้านค้า

entryKey string

กุญแจที่ระบุเอาต์พุต

scope string

ค่าเริ่มต้นคือ global โดยเริ่มต้น ดู ขอบเขต

cursor string

ให้ขอข้อมูลชุดต่อไป (ดู เคอร์เซอร์)

startTime string

ให้ไม่รวมเวอร์ชันก่อนหน้านี้กว่าเวลาที่บันทึก

endTime string

ให้ไม่รวมเวอร์ชันที่เก่ากว่าเวลาที่บันทึกนี้ในภายหลัง

sortOrder string

ไม่ว่าจะเป็น Ascending (เวอร์ชันก่อนหน้านี้ก่อน) หรือ Descending (เวอร์ชันใหม่ล่าสุดก่อน)

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

เวลาที่สร้างรุ่นในรูปแบบเวลาของ ISO เมื่อสร้างรุ่น

objectCreatedTime string

เวลาที่เก็บข้อมูลถูกสร้างในรูปแบบเวลา ISO

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

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

  • List Versions

วัตถุ

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

DataStore

วัตถุที่เก็บข้อมูลด้วยชื่อและเวลาที่สร้าง

คุณลักษณะ

name string

ร้านค้า

createdTime string

เวลาที่เก็บข้อมูลถูกสร้างในรูปแบบเวลา ISO

EntryVersion

วัตถุเวอร์ชันการเข้าสู่ระบบที่ส่งคืนโดยวิธี List Entry Versions

คุณลักษณะ

version string

ชื่อเวอร์ชันของบันทึกที่มีคุณสมบัติ

deleted boolean

บ่งบอกว่าการบันทึกถูกลบหรือไม่

contentLength number

ความยาวของเนื้อหา

createdTime string

เวลาที่สร้างรุ่นในรูปแบบเวลาของ ISO เมื่อสร้างรุ่น

objectCreatedTime string

เวลาที่เก็บข้อมูลถูกสร้างในรูปแบบเวลา ISO