API สินทรัพย์

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

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

Assets

https://apis.roblox.com/assets

รายการเวอร์ชันสินทรัพย์

GET /assets/v1/assets/{assetId}/versions

รวบรวมเวอร์ชันทั้งหมดของสินทรัพย์เฉพาะด้วยการจัดหน้าที่เลือกได้

พารามิเตอร์

assetId string

ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์

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

ระบุจํานวนรุ่นสินทรัพย์ที่จะรวมอยู่ในคําตอบ มีค่าที่ถูกต้องอยู่ระหว่าง 1 ถึง 50 (รวม) ค่าเริ่มต้นคือ 8 เมื่อไม่ได้ระบุ

pageToken string

โทเค็นสําหรับการจัดหน้า มูลค่าจะได้รับจากคําขอก่อนหน้าและสามารถดึงหน้าต่อไปของเวอร์ชันสินทรัพย์ได้

คำขอ

List Asset Versions

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions?pageToken=&maxPageSize=' \
--header 'x-api-key: {apiKey}'

การตอบกลับ

200 - OK
รายการเวอร์ชันสินทรัพย์ที่ระบุอย่างถูกต้อง
ส่งคืน array<object>

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

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

  • อ่าน

การจำกัด

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

รุ่นเวอร์ชันทรัพยากรย้อนกลับ

POST /assets/v1/assets/{assetId}/versions:rollback

ย้อนกลับสินทรัพย์ไปสู่รุ่นก่อนหน้าที่เฉพาะเจาะจง

ให้เส้นทางเวอร์ชันสินทรัพย์ในข้อมูลแบบฟอร์ม

พารามิเตอร์

assetId string

ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์

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

คำขอ

Rollback Asset Versions

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions:rollback' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json' \
--data '{\"assetVersion\":\"assets/{assetId}/versions/{versionNumber}\"}'

การตอบกลับ

200 - OK
สินทรัพย์ถูกดึงกลับอย่างสําเร็จ
ส่งคืน object
creationContext object

บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร

moderationResult object

ผลการคัดกรองของสินทรัพย์

path string

เส้นทางทรัพยากรที่ส่งคืนของเวอร์ชันสินทรัพย์ รูปแบบ: assets/{assetId}/versions/{version} . ตัวอย่าง: assets/2205400862/versions/1 .

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

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

  • อ่าน

  • เขียน

การจำกัด

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

สร้างสินทรัพย์

POST /v1/assets

สร้างสินทรัพย์ที่มีเนื้อหาและเมทาดาตที่กำหนดไว้

คุณไม่สามารถเพิ่มวัตถุ SocialLink เมื่อสร้างสินทรัพย์ได้ แทนที่จะใช้ อัปเดตสินทรัพย์

ให้ ทรัพยากร , เส้นทางไฟล์ทรัพยากรไบนารี, และ ประเภทเนื้อหา ในข้อมูลแบบฟอร์ม

คำขอ

Create Asset

curl --location --request POST 'https://apis.roblox.com/assets/v1/assets' \
--header 'x-api-key: {apiKey}' \
--form 'request="{
\"assetType\": \"Model\",
\"displayName\": \"Name\",
\"description\": \"This is a description\",
\"creationContext\": {
\"creator\": {
\"userId\": \"${userId}\"
}
}
}"' \
--form 'fileContent=@"/filepath/model.fbx";type=model/fbx'

การตอบกลับ

200 - OK
ส่งคืนรหัสการดำเนินการเพื่อตรวจสอบสถานะการสร้าง
ส่งคืน object
done boolean

หาก false , การดำเนินการยังคงดำเนินอยู่ หาก true , การดำเนินการสําเร็จ

error object

โมเดลข้อผิดพลาดทางเหตุผลที่อธิบายสถานะข้อผิดพลาด

metadata object

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

path string

เส้นทางทรัพยากรที่กำหนดโดยเซิร์ฟเวอร์ รูปแบบเริ่มต้นคือ operations/{operation_id}

response object

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

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

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

  • อ่าน

  • เขียน

การจำกัด

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

รับสินทรัพย์

GET /v1/assets/{assetId}

ดึงเนื้อหาและเมทาดาต้าสินทรัพย์เฉพาะ

พารามิเตอร์

assetId string

ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์

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

ดึงข้อมูลรวมถึงคำอธิบาย ชื่อแสดง ไอคอน ลิงก์โซเชียล และภาพตัวอย่าง ตัวอย่าง: description%2CdisplayName , previews%2CtwitchSocialLink .

คำขอ

Get Asset without readMask

curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}' \
--header 'x-api-key: {apiKey}'
Get Asset with readMask

curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}?readMask={read_mask}' \
--header 'x-api-key: {apiKey}'

การตอบกลับ

200 - OK
ค้นหาทรัพยากรสินทรัพย์สําเร็จ
ส่งคืน object
assetId number

รหัสระบุที่ไม่ซ้ำกันของสินทรัพย์ จำเป็นสำหรับ อัปเดตสินทรัพย์

assetType string

พิมพ์สามารถเป็นได้เฉพาะ Audio , Decal หรือ Model จำเป็นต้องใช้สำหรับ สร้างสินทรัพย์

creationContext object

บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร

description string

คำอธิบายของสินทรัพย์ จํากัดไว้ที่ 1000 ตัวอักษร จําเป็นสําหรับ สร้างสินทรัพย์

displayName string

ชื่อแสดงของสินทรัพย์ จำเป็นสำหรับ สร้างสินทรัพย์

icon string

เส้นทางทรัพยากรสำหรับไอคอน

moderationResult object

ผลการคัดกรองของสินทรัพย์

path string

เส้นทางทรัพยากรที่ส่งคืนของสินทรัพย์ รูปแบบ: assets/{assetId} . ตัวอย่าง: assets/2205400862 .

previews array<object>

รายการตัวอย่างแต่ละรายการมีเส้นทางสินทรัพย์และข้อความ alt ตัวอย่างต้องเป็น รูปภาพ สินทรัพย์

revisionCreateTime string

เวลาที่สร้างของรุ่นปัจจุบัน ของการแก้ไข

revisionId string

รหัสการแก้ไขของสินทรัพย์เทียบเท่ากับ versionNumber .ทุกการเปลี่ยนแปลงของสินทรัพย์จะส่งคอมมิตรุ่นใหม่โดยอัตโนมัติรูปแบบเป็นสตริงตัวเลขตัวอย่าง: 1 .

socialLink object

ลิงค์โซเชียลมีเดียสำหรับสินทรัพย์สูงสุดสามต่อสินทรัพย์ชื่อวัตถุสามารถเป็นได้ทั้งหมด:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink
  • twitchSocialLink
  • discordSocialLink
  • githubSocialLink
  • robloxSocialLink
  • guildedSocialLink
  • devForumSocialLink
สำหรับคําสั่งซื้อตัวอย่างดูที่คําขออัปเดตทรัพยากรภายใต้ อัปเดตทรัพยากร

state string

ว่าสินทรัพย์จะใช้งานหรือถูกจัดเก็บไว้ ไม่ได้ระบุไว้จะไม่ถูกใช้

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

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

  • อ่าน

การจำกัด

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

อัปเดตสินทรัพย์

PATCH /v1/assets/{assetId}

อัปเดตสินทรัพย์ด้วยเนื้อหาและเมทาดาตที่ให้ไว้ รวมถึงคำอธิบาย ชื่อแสดง ไอคอน ลิงก์โซเชียล และภาพตัวอย่างขณะนี้สามารถอัปเดตเนื้อหาได้เฉพาะสำหรับ รูปแบบ เท่านั้นไอคอนและตัวอย่างต้องเป็นสินทรัพย์ รูปภาพ ไอคอนต้องมีขนาดสี่เหลี่ยม

ให้ ทรัพยากร , เส้นทางไฟล์ทรัพยากรไบนารี, และ ประเภทเนื้อหา ในข้อมูลแบบฟอร์ม

พารามิเตอร์

assetId string

ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์

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

ชื่อที่แสดงตัวอย่าง: description%2CdisplayName , previews%2CtwitchSocialLink .

คำขอ

Update Content Only and Create a New Version

curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}' \
--header 'x-api-key: {apiKey}' \
--form 'request="{\"assetId\": {assetId} }"' \
--form 'fileContent="@\"{file-path}\""'
Update Content and Metadata

Update a List of Previews

curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=previews' \
--header 'x-api-key: {apiKey}' \
--form 'request="{\"assetId\": \"{assetId}\", \"previews\": [{\"asset\": \"assets/123\", \"altText\": \"Your alt text.\"}]}"'
Update Social Links

การตอบกลับ

200 - OK
ส่งคืนรหัสการดำเนินการเพื่อตรวจสอบสถานะการอัปเดต / ส่งคืนฟิลด์เมทาดาตาที่อัปเดต
ส่งคืน object
application/json

{"previews": [
{"asset": "assets/123", "altText": "preview 1"},
{"asset": "assets/456", "altText": "preview 2"}
]}
done boolean

หาก false , การดำเนินการยังคงดำเนินอยู่ หาก true , การดำเนินการสําเร็จ

error object

โมเดลข้อผิดพลาดทางเหตุผลที่อธิบายสถานะข้อผิดพลาด

metadata object

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

path string

เส้นทางทรัพยากรที่กำหนดโดยเซิร์ฟเวอร์ รูปแบบเริ่มต้นคือ operations/{operation_id}

response object

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

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

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

  • อ่าน

  • เขียน

การจำกัด

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

รับรุ่นของสินทรัพย์

GET /v1/assets/{assetId}/versions/{versionNumber}

ดึงรุ่นสินทรัพย์เฉพาะโดยรหัสสินทรัพย์และหมายเลขรุ่น

พารามิเตอร์

assetId string

ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์

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

หมายเลขรุ่น

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

คำขอ

Get Asset Version

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}/versions/{versionNumber}' \
--header 'x-api-key: {apiKey}'

การตอบกลับ

200 - OK
สามารถดึงเวอร์ชันสินทรัพย์ได้สำเร็จ
ส่งคืน object
creationContext object

บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร

moderationResult object

ผลการคัดกรองของสินทรัพย์

path string

เส้นทางทรัพยากรที่ส่งคืนของเวอร์ชันสินทรัพย์ รูปแบบ: assets/{assetId}/versions/{version} . ตัวอย่าง: assets/2205400862/versions/1 .

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

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

  • อ่าน

การจำกัด

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

สินทรัพย์คลังข้อมูล

POST /v1/assets/{assetId}:archive

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

พารามิเตอร์

assetId string

ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์

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

คำขอ

Archive Asset

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:archive' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'

การตอบกลับ

200 - OK
สินทรัพย์ถูกจัดเก็บอย่างประสบความสำเร็จอย่างสมบูรณ์
ส่งคืน object
assetId number

รหัสระบุที่ไม่ซ้ำกันของสินทรัพย์ จำเป็นสำหรับ อัปเดตสินทรัพย์

assetType string

พิมพ์สามารถเป็นได้เฉพาะ Audio , Decal หรือ Model จำเป็นต้องใช้สำหรับ สร้างสินทรัพย์

creationContext object

บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร

description string

คำอธิบายของสินทรัพย์ จํากัดไว้ที่ 1000 ตัวอักษร จําเป็นสําหรับ สร้างสินทรัพย์

displayName string

ชื่อแสดงของสินทรัพย์ จำเป็นสำหรับ สร้างสินทรัพย์

icon string

เส้นทางทรัพยากรสำหรับไอคอน

moderationResult object

ผลการคัดกรองของสินทรัพย์

path string

เส้นทางทรัพยากรที่ส่งคืนของสินทรัพย์ รูปแบบ: assets/{assetId} . ตัวอย่าง: assets/2205400862 .

previews array<object>

รายการตัวอย่างแต่ละรายการมีเส้นทางสินทรัพย์และข้อความ alt ตัวอย่างต้องเป็น รูปภาพ สินทรัพย์

revisionCreateTime string

เวลาที่สร้างของรุ่นปัจจุบัน ของการแก้ไข

revisionId string

รหัสการแก้ไขของสินทรัพย์เทียบเท่ากับ versionNumber .ทุกการเปลี่ยนแปลงของสินทรัพย์จะส่งคอมมิตรุ่นใหม่โดยอัตโนมัติรูปแบบเป็นสตริงตัวเลขตัวอย่าง: 1 .

socialLink object

ลิงค์โซเชียลมีเดียสำหรับสินทรัพย์สูงสุดสามต่อสินทรัพย์ชื่อวัตถุสามารถเป็นได้ทั้งหมด:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink
  • twitchSocialLink
  • discordSocialLink
  • githubSocialLink
  • robloxSocialLink
  • guildedSocialLink
  • devForumSocialLink
สำหรับคําสั่งซื้อตัวอย่างดูที่คําขออัปเดตทรัพยากรภายใต้ อัปเดตทรัพยากร

state string

ว่าสินทรัพย์จะใช้งานหรือถูกจัดเก็บไว้ ไม่ได้ระบุไว้จะไม่ถูกใช้

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

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

  • อ่าน

  • เขียน

การจำกัด

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

ฟื้นฟูสินทรัพย์

POST /v1/assets/{assetId}:restore

ฟื้นฟูสินทรัพย์ที่ถูกบันทึกไว้

พารามิเตอร์

assetId string

ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์

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

คำขอ

Restore Asset

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:restore' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'

การตอบกลับ

200 - OK
ฟื้นฟูสินทรัพย์สำเร็จ
ส่งคืน object
assetId number

รหัสระบุที่ไม่ซ้ำกันของสินทรัพย์ จำเป็นสำหรับ อัปเดตสินทรัพย์

assetType string

พิมพ์สามารถเป็นได้เฉพาะ Audio , Decal หรือ Model จำเป็นต้องใช้สำหรับ สร้างสินทรัพย์

creationContext object

บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร

description string

คำอธิบายของสินทรัพย์ จํากัดไว้ที่ 1000 ตัวอักษร จําเป็นสําหรับ สร้างสินทรัพย์

displayName string

ชื่อแสดงของสินทรัพย์ จำเป็นสำหรับ สร้างสินทรัพย์

icon string

เส้นทางทรัพยากรสำหรับไอคอน

moderationResult object

ผลการคัดกรองของสินทรัพย์

path string

เส้นทางทรัพยากรที่ส่งคืนของสินทรัพย์ รูปแบบ: assets/{assetId} . ตัวอย่าง: assets/2205400862 .

previews array<object>

รายการตัวอย่างแต่ละรายการมีเส้นทางสินทรัพย์และข้อความ alt ตัวอย่างต้องเป็น รูปภาพ สินทรัพย์

revisionCreateTime string

เวลาที่สร้างของรุ่นปัจจุบัน ของการแก้ไข

revisionId string

รหัสการแก้ไขของสินทรัพย์เทียบเท่ากับ versionNumber .ทุกการเปลี่ยนแปลงของสินทรัพย์จะส่งคอมมิตรุ่นใหม่โดยอัตโนมัติรูปแบบเป็นสตริงตัวเลขตัวอย่าง: 1 .

socialLink object

ลิงค์โซเชียลมีเดียสำหรับสินทรัพย์สูงสุดสามต่อสินทรัพย์ชื่อวัตถุสามารถเป็นได้ทั้งหมด:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink
  • twitchSocialLink
  • discordSocialLink
  • githubSocialLink
  • robloxSocialLink
  • guildedSocialLink
  • devForumSocialLink
สำหรับคําสั่งซื้อตัวอย่างดูที่คําขออัปเดตทรัพยากรภายใต้ อัปเดตทรัพยากร

state string

ว่าสินทรัพย์จะใช้งานหรือถูกจัดเก็บไว้ ไม่ได้ระบุไว้จะไม่ถูกใช้

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

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

  • อ่าน

  • เขียน

การจำกัด

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

รับการดำเนินการ

GET /v1/operations/{operationId}

รับผลลัพธ์ของการสร้างหรืออัปเดตสินทรัพย์โดยใช้รหัสการดำเนินการที่ส่งกลับต้องการ อ่าน สำหรับสิทธิ์กุญแจ API และ อ่านทรัพยากร:อ่าน สำหรับแอป OAuth 2.0

พารามิเตอร์

operationId string

รหัสระบุเฉพาะของการดำเนินการ

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

คำขอ

Get Operation

curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \
--header 'x-api-key: {apiKey}'

การตอบกลับ

200 - OK
การดึงผลการดำเนินการสำเร็จ
ส่งคืน object
done boolean

หาก false , การดำเนินการยังคงดำเนินอยู่ หาก true , การดำเนินการสําเร็จ

error object

โมเดลข้อผิดพลาดทางเหตุผลที่อธิบายสถานะข้อผิดพลาด

metadata object

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

path string

เส้นทางทรัพยากรที่กำหนดโดยเซิร์ฟเวอร์ รูปแบบเริ่มต้นคือ operations/{operation_id}

response object

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

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

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

  • อ่าน

การจำกัด

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

วัตถุ

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

Any

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

คุณลักษณะ

@type string

ประเภทของข้อความที่เข้ารหัส

Asset

แทนที่สินทรัพย์

คุณลักษณะ

assetId number

รหัสระบุที่ไม่ซ้ำกันของสินทรัพย์ จำเป็นสำหรับ อัปเดตสินทรัพย์

assetType string

พิมพ์สามารถเป็นได้เฉพาะ Audio , Decal หรือ Model จำเป็นต้องใช้สำหรับ สร้างสินทรัพย์

creationContext object

บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร

description string

คำอธิบายของสินทรัพย์ จํากัดไว้ที่ 1000 ตัวอักษร จําเป็นสําหรับ สร้างสินทรัพย์

displayName string

ชื่อแสดงของสินทรัพย์ จำเป็นสำหรับ สร้างสินทรัพย์

icon string

เส้นทางทรัพยากรสำหรับไอคอน

moderationResult object

ผลการคัดกรองของสินทรัพย์

path string

เส้นทางทรัพยากรที่ส่งคืนของสินทรัพย์ รูปแบบ: assets/{assetId} . ตัวอย่าง: assets/2205400862 .

previews array<object>

รายการตัวอย่างแต่ละรายการมีเส้นทางสินทรัพย์และข้อความ alt ตัวอย่างต้องเป็น รูปภาพ สินทรัพย์

revisionCreateTime string

เวลาที่สร้างของรุ่นปัจจุบัน ของการแก้ไข

revisionId string

รหัสการแก้ไขของสินทรัพย์เทียบเท่ากับ versionNumber .ทุกการเปลี่ยนแปลงของสินทรัพย์จะส่งคอมมิตรุ่นใหม่โดยอัตโนมัติรูปแบบเป็นสตริงตัวเลขตัวอย่าง: 1 .

socialLink object

ลิงค์โซเชียลมีเดียสำหรับสินทรัพย์สูงสุดสามต่อสินทรัพย์ชื่อวัตถุสามารถเป็นได้ทั้งหมด:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink
  • twitchSocialLink
  • discordSocialLink
  • githubSocialLink
  • robloxSocialLink
  • guildedSocialLink
  • devForumSocialLink
สำหรับคําสั่งซื้อตัวอย่างดูที่คําขออัปเดตทรัพยากรภายใต้ อัปเดตทรัพยากร

state string

ว่าสินทรัพย์จะใช้งานหรือถูกจัดเก็บไว้ ไม่ได้ระบุไว้จะไม่ถูกใช้

AssetVersion

รุ่นสินทรัพย์

คุณลักษณะ

creationContext object

บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร

moderationResult object

ผลการคัดกรองของสินทรัพย์

path string

เส้นทางทรัพยากรที่ส่งคืนของเวอร์ชันสินทรัพย์ รูปแบบ: assets/{assetId}/versions/{version} . ตัวอย่าง: assets/2205400862/versions/1 .

CreationContext

บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร

คุณลักษณะ

creator object

แทนที่ผู้สร้าง

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

ค่าธรรมเนียมการอัปโหลดสินทรัพย์ที่คาดไว้ใน Robux เมื่อราคาจริงสูงกว่าที่คาดไว้ การดำเนินการจะล้มเหลวด้วยข้อผิดพลาด 400

Creator

แทนที่ผู้สร้าง

คุณลักษณะ

groupId number

ID กลุ่ม จำเป็นถ้าสินทรัพย์เป็นของกลุ่ม

userId number

ID ครีเอเตอร์จำเป็นถ้าสินทรัพย์เป็นของผู้ใช้รายบุคคล

ModerationResult

ผลการคัดกรองของสินทรัพย์

คุณลักษณะ

moderationState string

สถานะการกลั่นกรองของสินทรัพย์ อาจเป็น Reviewing , Rejected หรือ Approved

Operation

ทรัพยากรนี้เป็นการดำเนินการที่ยาวนานซึ่งเป็นผลมาจากการโทร API เครือข่าย

คุณลักษณะ

done boolean

หาก false , การดำเนินการยังคงดำเนินอยู่ หาก true , การดำเนินการสําเร็จ

error object

โมเดลข้อผิดพลาดทางเหตุผลที่อธิบายสถานะข้อผิดพลาด

metadata object

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

path string

เส้นทางทรัพยากรที่กำหนดโดยเซิร์ฟเวอร์ รูปแบบเริ่มต้นคือ operations/{operation_id}

response object

ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง

Preview

การดูตัวอย่างสินทรัพย์

คุณลักษณะ

altText string

ข้อความทดแทนสำหรับสินทรัพย์ตัวอย่าง

asset string

เส้นทางสินทรัพย์ตัวอย่าง

ลิงค์โซเชียลมีเดียสำหรับสินทรัพย์สูงสุดสามต่อสินทรัพย์ชื่อวัตถุสามารถเป็นได้ทั้งหมด:

  • facebookSocialLink
  • twitterSocialLink
  • youtubeSocialLink
  • twitchSocialLink
  • discordSocialLink
  • githubSocialLink
  • robloxSocialLink
  • guildedSocialLink
  • devForumSocialLink
สำหรับคําสั่งซื้อตัวอย่างดูที่คําขออัปเดตทรัพยากรภายใต้ อัปเดตทรัพยากร

คุณลักษณะ

title string

เชื่อมโยงไม่ใช้ใน ศูนย์กลางครีเอเตอร์

uri string

URI เชื่อมโยงชื่อของวัตถุ twitchSocialLink จะต้องเป็นรูปแบบ https://twitch.tv/your-channel

State

ว่าสินทรัพย์จะใช้งานหรือถูกจัดเก็บไว้ ไม่ได้ระบุไว้จะไม่ถูกใช้

คุณลักษณะ

string (enum): "Unspecified", "Active", "Archived"

Status

โมเดลข้อผิดพลาดทางเหตุผลที่อธิบายสถานะข้อผิดพลาด

คุณลักษณะ

code number

รหัสสถานะ HTTP

details array<object>

รายการข้อความที่มีรายละเอียดข้อผิดพลาด

message string

ข้อความข้อผิดพลาด