ร้านค้าข้อมูลสั่งซื้อ (เบต้า)

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

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

OrderedDataStores

https://apis.roblox.com/ordered-data-stores

รายการ

GET /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries

กลับรายการของรายการจากร้านค้าข้อมูลที่สั่งซื้อ

พารามิเตอร์

universeId string

รหัสประจำตัวประสบการณ์ที่คุณต้องการเข้าถึง ดู รหัสจักรวาล เกี่ยวกับวิธีการคัดลอกได้ที่ Dashboard ของผู้สร้าง

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

ชื่อของร้านค้าข้อมูลเป้าหมายที่สั่ง

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

ชื่อของขอบเขตห้องเก็บข้อมูลดังนั้นดู Scopes

Path
จำเป็นต้องมี
max_page_size number

จำนวนเงินสูงสุดที่จะกลับมา บริการอาจกลับน้อยกว่าค่านี้ ค่าเริ่มต้นคือ 10 และค่าสูงสุดคือ 100 และการป้อนใด ๆ เหนือ 100 ถูกบังคับให้เป็น 1

page_token string

หน้าโทเค็นที่ได้รับจากการโทร List ก่อนหน้านี้ ให้สิ่งนี้เพื่อดึงหน้าต่อไป เมื่อชำระเงินจะต้องมีค่าตัวอื่นทั้งหมดที่ให้กับ List เท่านั้น

order_by string

ทิศทางการเรียงลำดับ คำสั่งโดยปกติคือขึ้น ใส่ค่า desc สำหรับการลง

filter string

ขอบเขตของค่าคุณสมบัติที่มีค่าในการส่งคืน ดู ตัวกรอง

คำขอ

curl
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \

 --header 'x-api-key: <insert-api-key>'

การตอบกลับ

200 - OK
ตกลง
ส่งคืน object
entries array<object>

รายการจากสเก็บข้อมูลที่กำหนด

nextPageToken string

โทเค็นซึ่งสามารถส่งเป็น page_token เพื่อดึงหน้าต่อไป หากส่วนนี้ถูกข้าม จะไม่มีหน้าต่อไป

สร้าง

POST /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries

สร้างรายการใหม่ด้วยค่าเนื้อหาที่ให้

พารามิเตอร์

universeId string

รหัสประจำตัวประสบการณ์ที่คุณต้องการเข้าถึง ดู รหัสจักรวาล เกี่ยวกับวิธีการคัดลอกได้ที่ Dashboard ของผู้สร้าง

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

ชื่อของร้านค้าข้อมูลที่สั่งซื้อ

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

ชื่อของขอบเขตห้องเก็บข้อมูลดังนั้นดู Scopes

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

ชื่อของรายการ

จำเป็นต้องมี
CreateEntryRequest

สร้างรายการใหม่ด้วยค่าที่กำหนด

Body
จำเป็นต้องมี

คำขอ

curl
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries?id=<id>' \

--header 'x-api-key: <insert-api-key>' \

--header 'Content-Type: application/json' \

--data '{ 

    "value": <long> 

}'

การตอบกลับ

200 - OK
ตกลง
ส่งคืน object
id string

ชื่อของรายการ

path string

เส้นทางทรัพยากรของคำขอ

value number

มูลค่าของรายการ

รับ

GET /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

รับและส่งรายการที่กำหนด

พารามิเตอร์

universeId string

รหัสประจำตัวประสบการณ์ที่คุณต้องการเข้าถึง ดู รหัสจักรวาล เกี่ยวกับวิธีการคัดลอกได้ที่ Dashboard ของผู้สร้าง

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

ชื่อของร้านค้าข้อมูลที่สั่งซื้อ

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

ชื่อของขอบเขตห้องเก็บข้อมูลดังนั้นดู Scopes

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

รหัสรายการ

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

คำขอ

curl
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \

 --header 'x-api-key: <insert-api-key>'

การตอบกลับ

200 - OK
ตกลง
ส่งคืน object
id string

ชื่อของรายการ

path string

เส้นทางทรัพยากรของคำขอ

value number

มูลค่าของรายการ

ลบ

DELETE /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

ลบรายการที่กำหนด

พารามิเตอร์

universeId string

รหัสประจำตัวประสบการณ์ที่คุณต้องการเข้าถึง ดู รหัสจักรวาล เกี่ยวกับวิธีการคัดลอกได้ที่ Dashboard ของผู้สร้าง

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

ชื่อของร้านค้าข้อมูลที่สั่งซื้อ

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

ชื่อของขอบเขตห้องเก็บข้อมูลดังนั้นดู Scopes

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

รหัสรายการ

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

คำขอ

curl
curl --location --request DELETE 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \

 --header 'x-api-key: <insert-api-key>'

การตอบกลับ

อัปเดต

PATCH /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

อัปเดตค่าเข้าและส่งค่าเข้าที่ปรับปรุงแก่คุณ

พารามิเตอร์

universeIdId string

รหัสประจำตัวประสบการณ์ที่คุณต้องการเข้าถึง ดู รหัสจักรวาล เกี่ยวกับวิธีการคัดลอกได้ที่ Dashboard ของผู้สร้าง

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

ชื่อของร้านค้าข้อมูลที่สั่งซื้อ

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

ชื่อของขอบเขตห้องเก็บข้อมูลดังนั้นดู Scopes

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

รหัสรายการ

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

อัปเดตรายการที่ให้ด้วยค่าใหม่

Body
จำเป็นต้องมี
allow_missing boolean

ธงเพื่ออนุญาตให้สร้างรายการหากรายการนั้นไม่มี ดู อนุญาตธงที่หายไป .

คำขอ

curl
curl --location --request PATCH 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \

--header 'x-api-key: <insert-api-key>' \

--header 'Content-Type: application/json' \

--data '{ 

    "value": <long> 

}'

การตอบกลับ

200 - OK
ตกลง
ส่งคืน object
id string

ชื่อของรายการ

path string

เส้นทางทรัพยากรของคำขอ

value number

มูลค่าของรายการ

เพิ่ม

POST /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}:increment

เพิ่มมูลค่าของกุญแจโดยจำนวนเงินที่กำหนดและส่งค่าการปรับปรุง

ปัญหาที่ทราบ: ค่าเข้าสู่สามารถเพิ่มขึ้นเหนือขอบเขตที่ถูกต้องได้ และนี่อาจเกิดขึ้นในแบ็กเอนด์ ค่าที่กลับมาจะปรับให้อยู่ในขอบเขตที่ถูกต้อง

พารามิเตอร์

universeId string

รหัสประจำตัวประสบการณ์ที่คุณต้องการเข้าถึง ดู รหัสจักรวาล เกี่ยวกับวิธีการคัดลอกได้ที่ Dashboard ของผู้สร้าง

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

ชื่อของร้านค้าข้อมูลที่สั่งซื้อ

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

ชื่อของขอบเขตห้องเก็บข้อมูลดังนั้นดู Scopes

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

รหัสรายการ

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

เพิ่มมูลค่าตัวอักษร

Body
จำเป็นต้องมี

คำขอ

curl
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>:increment' \

--header 'x-api-key: <insert-api-key>' \

--header 'Content-Type: application/json' \

--data '{ 

    "amount": <long> 

}'

การตอบกลับ

200 - OK
ตกลง
ส่งคืน object
id string

ชื่อของรายการ

path string

เส้นทางทรัพยากรของคำขอ

value number

มูลค่าของรายการ

วัตถุ

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

CreateEntryRequest

สร้างรายการใหม่ด้วยค่าที่กำหนด

คุณลักษณะ

value number

ค่าที่ต้องการตั้งใหม่ หากค่าป้อนเกินมาตรฐานสูงสุดที่รองรับโดย int64 ซึ่งคือ 9,223,372,036,854,775,807, คำขอล้มเหลวด้วยข้อผิดพลาด 400 Bad Request

Entry

แทนที่เข้าสู่

คุณลักษณะ

id string

ชื่อของรายการ

path string

เส้นทางทรัพยากรของคำขอ

value number

มูลค่าของรายการ

IncrementEntryRequest

เพิ่มมูลค่าตัวอักษร

คุณลักษณะ

amount number

จำนวนเงินที่เพิ่มขึ้นโดยค่าเข้า. หากค่าป้อนเกินมาตรฐานสูงสุดที่สนับสนุนโดย int64 ซึ่งคือ 9,223,372,036,854,775,807, คำขอล้มเหลวด้วยข้อผิดพลาด 400 Bad Request.

ListEntriesResponse

รายการรายการในคอลเลกชันพ่อ.

คุณลักษณะ

entries array<object>

รายการจากสเก็บข้อมูลที่กำหนด

nextPageToken string

โทเค็นซึ่งสามารถส่งเป็น page_token เพื่อดึงหน้าต่อไป หากส่วนนี้ถูกข้าม จะไม่มีหน้าต่อไป

UpdateEntryRequest

อัปเดตรายการที่ให้ด้วยค่าใหม่

คุณลักษณะ

value number

ค่าที่ต้องการปรับปรุงรายการ หากค่าป้อนเกินมาตรฐานที่สนับสนุนโดย int64 ซึ่งคือ 9,223,372,036,854,775,807, คำขอล้มเหลวด้วยข้อผิดพลาด 400 Bad Request