API สินทรัพย์
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
Assets
รายการเวอร์ชันสินทรัพย์
รวบรวมเวอร์ชันทั้งหมดของสินทรัพย์เฉพาะด้วยการจัดหน้าที่เลือกได้
พารามิเตอร์
ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์
ระบุจํานวนรุ่นสินทรัพย์ที่จะรวมอยู่ในคําตอบ มีค่าที่ถูกต้องอยู่ระหว่าง 1 ถึง 50 (รวม) ค่าเริ่มต้นคือ 8 เมื่อไม่ได้ระบุ
โทเค็นสําหรับการจัดหน้า มูลค่าจะได้รับจากคําขอก่อนหน้าและสามารถดึงหน้าต่อไปของเวอร์ชันสินทรัพย์ได้
คำขอ
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions?pageToken=&maxPageSize=' \
--header 'x-api-key: {apiKey}'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 100 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
รุ่นเวอร์ชันทรัพยากรย้อนกลับ
ย้อนกลับสินทรัพย์ไปสู่รุ่นก่อนหน้าที่เฉพาะเจาะจง
ให้เส้นทางเวอร์ชันสินทรัพย์ในข้อมูลแบบฟอร์ม
พารามิเตอร์
ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์
คำขอ
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}\"}'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 100 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
สร้างสินทรัพย์
สร้างสินทรัพย์ที่มีเนื้อหาและเมทาดาตที่กำหนดไว้
คุณไม่สามารถเพิ่มวัตถุ SocialLink เมื่อสร้างสินทรัพย์ได้ แทนที่จะใช้ อัปเดตสินทรัพย์
ให้ ทรัพยากร , เส้นทางไฟล์ทรัพยากรไบนารี, และ ประเภทเนื้อหา ในข้อมูลแบบฟอร์ม
คำขอ
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'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
รับสินทรัพย์
ดึงเนื้อหาและเมทาดาต้าสินทรัพย์เฉพาะ
พารามิเตอร์
ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์
ดึงข้อมูลรวมถึงคำอธิบาย ชื่อแสดง ไอคอน ลิงก์โซเชียล และภาพตัวอย่าง ตัวอย่าง: description%2CdisplayName , previews%2CtwitchSocialLink .
คำขอ
curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}' \
--header 'x-api-key: {apiKey}'
curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}?readMask={read_mask}' \
--header 'x-api-key: {apiKey}'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
อัปเดตสินทรัพย์
อัปเดตสินทรัพย์ด้วยเนื้อหาและเมทาดาตที่ให้ไว้ รวมถึงคำอธิบาย ชื่อแสดง ไอคอน ลิงก์โซเชียล และภาพตัวอย่างขณะนี้สามารถอัปเดตเนื้อหาได้เฉพาะสำหรับ รูปแบบ เท่านั้นไอคอนและตัวอย่างต้องเป็นสินทรัพย์ รูปภาพ ไอคอนต้องมีขนาดสี่เหลี่ยม
ให้ ทรัพยากร , เส้นทางไฟล์ทรัพยากรไบนารี, และ ประเภทเนื้อหา ในข้อมูลแบบฟอร์ม
พารามิเตอร์
ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์
ชื่อที่แสดงตัวอย่าง: description%2CdisplayName , previews%2CtwitchSocialLink .
คำขอ
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}\""'
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=description%2CdisplayName' \
--header 'x-api-key: {apiKey}' \
--form 'request="{
\"assetType\": \"{assetType}\",
\"assetId\": {assetId},
\"displayName\": \"{new display name}\",
\"description\": \"{new description}\",
\"creationContext\": {
\"creator\": {
\"userId\": {userId}
},
\"expectedPrice\":{expectedPrice}
},
}"' \
--form 'fileContent=@\"{file-path}\"'
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.\"}]}"'
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=twitchSocialLink%2CgithubSocialLink' \
--header 'x-api-key: {apiKey}' \
--form 'request="{\"assetId\": \"{assetId}\", \"twitchSocialLink\": {\"title\": \"Optional title\", \"uri\": \"https://twitch.tv/your-channel\"}, \"githubSocialLink\": {\"title\": \"Optional title\", \"uri\": \"https://github.com/your-repo\"}}"'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
รับรุ่นของสินทรัพย์
ดึงรุ่นสินทรัพย์เฉพาะโดยรหัสสินทรัพย์และหมายเลขรุ่น
พารามิเตอร์
ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์
หมายเลขรุ่น
คำขอ
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}/versions/{versionNumber}' \
--header 'x-api-key: {apiKey}'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 100 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
สินทรัพย์คลังข้อมูล
บันทึกสินทรัพย์สินทรัพย์ที่ถูกจัดเก็บจะหายไปจากเว็บไซต์และไม่สามารถใช้งานหรือมองเห็นได้ในประสบการณ์ Roblox อีกต่อไป แต่คุณสามารถ ฟื้นฟู พวกเขาได้
พารามิเตอร์
ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์
คำขอ
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:archive' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 100 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
ฟื้นฟูสินทรัพย์
ฟื้นฟูสินทรัพย์ที่ถูกบันทึกไว้
พารามิเตอร์
ตัวระบุที่ไม่ซ้ำกันของสินทรัพย์
คำขอ
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:restore' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 100 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
รับการดำเนินการ
รับผลลัพธ์ของการสร้างหรืออัปเดตสินทรัพย์โดยใช้รหัสการดำเนินการที่ส่งกลับต้องการ อ่าน สำหรับสิทธิ์กุญแจ API และ อ่านทรัพยากร:อ่าน สำหรับแอป OAuth 2.0
พารามิเตอร์
รหัสระบุเฉพาะของการดำเนินการ
คำขอ
curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \
--header 'x-api-key: {apiKey}'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
การจำกัด
ต่อคีย์ API: 100 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
วัตถุ
วัตถุต่อไปนี้ใช้บรรยายเพย์โหลดที่ยอมรับหรือส่งคืน ดูข้อมูลเพิ่มเติมว่าจะใช้วัตถุเหล่านี้ตอนไหนที่ Endpoint แต่ละจุด
Any
ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง
คุณลักษณะ
ประเภทของข้อความที่เข้ารหัส
Asset
แทนที่สินทรัพย์
คุณลักษณะ
รหัสระบุที่ไม่ซ้ำกันของสินทรัพย์ จำเป็นสำหรับ อัปเดตสินทรัพย์
พิมพ์สามารถเป็นได้เฉพาะ Audio , Decal หรือ Model จำเป็นต้องใช้สำหรับ สร้างสินทรัพย์
บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร
คำอธิบายของสินทรัพย์ จํากัดไว้ที่ 1000 ตัวอักษร จําเป็นสําหรับ สร้างสินทรัพย์
ชื่อแสดงของสินทรัพย์ จำเป็นสำหรับ สร้างสินทรัพย์
เส้นทางทรัพยากรสำหรับไอคอน
ผลการคัดกรองของสินทรัพย์
เส้นทางทรัพยากรที่ส่งคืนของสินทรัพย์ รูปแบบ: assets/{assetId} . ตัวอย่าง: assets/2205400862 .
รายการตัวอย่างแต่ละรายการมีเส้นทางสินทรัพย์และข้อความ alt ตัวอย่างต้องเป็น รูปภาพ สินทรัพย์
เวลาที่สร้างของรุ่นปัจจุบัน ของการแก้ไข
รหัสการแก้ไขของสินทรัพย์เทียบเท่ากับ versionNumber .ทุกการเปลี่ยนแปลงของสินทรัพย์จะส่งคอมมิตรุ่นใหม่โดยอัตโนมัติรูปแบบเป็นสตริงตัวเลขตัวอย่าง: 1 .
ลิงค์โซเชียลมีเดียสำหรับสินทรัพย์สูงสุดสามต่อสินทรัพย์ชื่อวัตถุสามารถเป็นได้ทั้งหมด:
- facebookSocialLink
- twitterSocialLink
- youtubeSocialLink
- twitchSocialLink
- discordSocialLink
- githubSocialLink
- robloxSocialLink
- guildedSocialLink
- devForumSocialLink
ว่าสินทรัพย์จะใช้งานหรือถูกจัดเก็บไว้ ไม่ได้ระบุไว้จะไม่ถูกใช้
AssetVersion
รุ่นสินทรัพย์
คุณลักษณะ
บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร
ผลการคัดกรองของสินทรัพย์
เส้นทางทรัพยากรที่ส่งคืนของเวอร์ชันสินทรัพย์ รูปแบบ: assets/{assetId}/versions/{version} . ตัวอย่าง: assets/2205400862/versions/1 .
CreationContext
บริบทของการสร้างที่ไม่ได้เป็นส่วนหนึ่งของเนื้อหาทรัพยากร เช่น ข้อมูลเมทาดาตาและข้อมูลผู้สร้าง จำเป็นสำหรับ สร้างทรัพยากร
คุณลักษณะ
แทนที่ผู้สร้าง
ค่าธรรมเนียมการอัปโหลดสินทรัพย์ที่คาดไว้ใน Robux เมื่อราคาจริงสูงกว่าที่คาดไว้ การดำเนินการจะล้มเหลวด้วยข้อผิดพลาด 400
Creator
แทนที่ผู้สร้าง
คุณลักษณะ
ID กลุ่ม จำเป็นถ้าสินทรัพย์เป็นของกลุ่ม
ID ครีเอเตอร์จำเป็นถ้าสินทรัพย์เป็นของผู้ใช้รายบุคคล
ModerationResult
ผลการคัดกรองของสินทรัพย์
คุณลักษณะ
สถานะการกลั่นกรองของสินทรัพย์ อาจเป็น Reviewing , Rejected หรือ Approved
Operation
ทรัพยากรนี้เป็นการดำเนินการที่ยาวนานซึ่งเป็นผลมาจากการโทร API เครือข่าย
คุณลักษณะ
หาก false , การดำเนินการยังคงดำเนินอยู่ หาก true , การดำเนินการสําเร็จ
โมเดลข้อผิดพลาดทางเหตุผลที่อธิบายสถานะข้อผิดพลาด
ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง
เส้นทางทรัพยากรที่กำหนดโดยเซิร์ฟเวอร์ รูปแบบเริ่มต้นคือ operations/{operation_id}
ประกอบด้วยข้อความที่เขียนโดยอิสระพร้อมกับ @type ที่อธิบายประเภทของข้อความที่เขียนลง
Preview
การดูตัวอย่างสินทรัพย์
คุณลักษณะ
ข้อความทดแทนสำหรับสินทรัพย์ตัวอย่าง
เส้นทางสินทรัพย์ตัวอย่าง
SocialLink
ลิงค์โซเชียลมีเดียสำหรับสินทรัพย์สูงสุดสามต่อสินทรัพย์ชื่อวัตถุสามารถเป็นได้ทั้งหมด:
- facebookSocialLink
- twitterSocialLink
- youtubeSocialLink
- twitchSocialLink
- discordSocialLink
- githubSocialLink
- robloxSocialLink
- guildedSocialLink
- devForumSocialLink
คุณลักษณะ
เชื่อมโยงไม่ใช้ใน ศูนย์กลางครีเอเตอร์
URI เชื่อมโยงชื่อของวัตถุ twitchSocialLink จะต้องเป็นรูปแบบ https://twitch.tv/your-channel
State
ว่าสินทรัพย์จะใช้งานหรือถูกจัดเก็บไว้ ไม่ได้ระบุไว้จะไม่ถูกใช้
คุณลักษณะ
Status
โมเดลข้อผิดพลาดทางเหตุผลที่อธิบายสถานะข้อผิดพลาด
คุณลักษณะ
รหัสสถานะ HTTP
รายการข้อความที่มีรายละเอียดข้อผิดพลาด
ข้อความข้อผิดพลาด