API สําหรับสินทรัพย์
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
คุณสามารถส่งและรับขอและตอบสนองด้านล่างเพื่อสร้างสินทรัพย์บน Roblox ได้ สำหรับข้อมูลเกี่ยวกับการใช้งาน API โปรดดูที่ คู่มือการใช้งาน
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
แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่การลงทะเบียนและการตรวจสอบแอป
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
รุ่นสมุดกลับ
สแน็ปแอสเซ็ตไปยังเวอร์ชันก่อนหน้าเฉพาะ
พารามิเตอร์
รหัสประจำตัวที่ไม่ซ้ำใครของสินทรัพย์
เส้นทางรุ่นสมุดในรูปแบบ assets/{assetId}/versions/{versionNumber}
คำขอ
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
แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่การลงทะเบียนและการตรวจสอบแอป
การจำกัด
ต่อคีย์ 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
แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่การลงทะเบียนและการตรวจสอบแอป
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
สร้างสินทรัพย์
สร้างสินทรัพย์ด้วยเนื้อหาและเมทาดักที่ให้ไว้
คุณไม่สามารถเพิ่มวัตถุ SocialLink เมื่อคุณสร้างสินทรัพย์ได้ แทนที่โดยใช้ ปรับปรุงสินทรัพย์
พารามิเตอร์
อัปเดตส่งเป็นข้อมูลแบบฟอร์มเช่นที่แสดงด้านล่าง
เส้นทางไฟล์ข้อมูลแบบข้อมูลของคอนเทนเนอร์ พิมพ์ตัวอย่าง: fileContent=@"/filepath/{File}";type={ContentType} ดู fileContent=@"/filepath/model.fbx";type=model/fbx .
คำขอ
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
แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่การลงทะเบียนและการตรวจสอบแอป
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
อัปเดตทรัพยากร
อัปเดตสินทรัพย์ด้วยเนื้อหาและเมทาดัตที่ให้ไว้ รวมถึงคำอธิบาย ชื่อแสดงผล ไอคอน ลิงค์โซเชียล และการดูตัวอย่าง ปัจจุบันสามารถอัปเดตตัวอย่างเนื้อหาสำหรับ โมเดล
พารามิเตอร์
ส่งข้อมูลรูปแบบเช่นคำขอตัวอย่างต่อไปนี้
เส้นทางไฟล์ข้อมูลแบบข้อมูลของคอนเทนเนอร์ พิมพ์ตัวอย่าง: fileContent=@"/filepath/{File}";type={ContentType} ดู fileContent=@"/filepath/model.fbx";type=model/fbx .
ข้อมูลแท็กติดตั้งสินทรัพย์ รวมถึงคำอธิบาย ชื่อแสดงผล ไอคอน และข้อมูลตัวอย่าง ตัวอย่าง: 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
แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่การลงทะเบียนและการตรวจสอบแอป
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
รับเวอร์ชันสินทรัพย์
ดึงรุ่นทรัพยากรโดยเฉพาะของทรัพยากรโดยรหัสทรัพยากรและหมายเลขเวอร์ชัน
พารามิเตอร์
รหัสประจำตัวที่ไม่ซ้ำใครของสินทรัพย์
หมายเลขเวอร์ชัน
คำขอ
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}/versions/{versionNumber}' \
--header 'x-api-key: {apiKey}'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่การลงทะเบียนและการตรวจสอบแอป
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
รับการดำเนินการ
รับผลการสร้างหรือปรับปรุงสินทรัพย์โดยการใช้รหัสการดำเนินการที่กลับมา ต้องการ อ่าน สำหรับการอนุญาตให้ API สำหรับการอ่าน OAuth 2.0 และ อ่าน สำหรับการอ่าน OAuth 2.0 สำหรับการอ่าน OAuth 2.
คำขอ
curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \
--header 'x-api-key: {apiKey}'
การตอบกลับ
สิทธิ์ที่ต้องมี
ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่จัดการคีย์ API
แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่การลงทะเบียนและการตรวจสอบแอป
การจำกัด
ต่อคีย์ API: 60 คำขอทุกๆ 60 วินาทีต่อที่อยู่ IP
วัตถุ
วัตถุต่อไปนี้ใช้บรรยายเพย์โหลดที่ยอมรับหรือส่งคืน ดูข้อมูลเพิ่มเติมว่าจะใช้วัตถุเหล่านี้ตอนไหนที่ Endpoint แต่ละจุด
Any
ประกอบด้วยข้อความซีรีเซอร์แบบสุ่มที่มี @type ที่อธิบายประเภทของข้อความซีรีเซอร์
คุณลักษณะ
ประเภทของข้อความซีรี่ยล
Asset
แทนที่สินทรัพย์
คุณลักษณะ
รหัสประจำตัวที่ไม่ซ้ำใครของสินทรัพย์ ต้องการสำหรับ ปรับปรุงสินทรัพย์
ประเภทสื่อ สามารถเป็นเฉพาะ Audio เท่านั้น Decal หรือ Model ต้องการสำหรับ 1> สร้างสื่อประเภทนี้1>
บริบทของการสร้างที่ไม่ใช่ส่วนหนึ่งของเนื้อหาสินทรัพย์ เช่น ข้อมูลเมทาดาต้าและข้อมูลผู้สร้าง ต้องการสำหรับ สร้างสินทรัพย์ .
คำอธิบายของสินทรัพย์ จํากัดไว้ที่ 1000 ตัวอักษร ต้องการสําหรับ สร้างสินทรัพย์
ชื่อแสดงของสินทรัพย์ ต้องการสำหรับ สร้างสินทรัพย์
เส้นทางทรัพยากรสำหรับไอคอน
ผลการกรองของสินทรัพย์
เส้นทางทรัพยากรที่กลับมาของสินทรัพย์ รูปแบบ: assets/{assetId} ตัวอย่าง: assets/2205400862
รายการแสดงตัวอย่าง แต่ละรายการมีเส้นทางสินทรัพย์และข้อความ alt รายการแสดงตัวอย่างต้องเป็น รายการภาพ สินทรัพย์
เวลาที่สร้างของรุ่นปัจจุบัน
รหัสการเปลี่ยนแปลงของสินทรัพย์ เทียบเท่ากับ versionNumber รุ่นใหม่ของสินทรัพย์จะถูกส่งออกโดยอัตโนมัติ สตริงตัวอย่าง: 1 .
ลิงค์สื่อสังคมออนไลน์สำหร
CreationContext
บริบทของการสร้างที่ไม่ใช่ส่วนหนึ่งของเนื้อหาสินทรัพย์ เช่น ข้อมูลเมทาดาต้าและข้อมูลผู้สร้าง ต้องการสำหรับ สร้างสินทรัพย์ .
คุณลักษณะ
ครีเอเตอร์
คาดหวังค่าอัปโหลดสินทรัพย์ใน Robux เมื่อราคาที่เป็นไปตามที่คาดไว้มีการผิดพลาด 400 ครั้ง
Creator
ครีเอเตอร์
คุณลักษณะ
รหัสกลุ่ม จำเป็นหากสินทรัพย์เป็นของกลุ่ม
ครีเอเตอร์ต้องการหากสินทรัพย์เป็นของผู้ใช้เดียว
ModerationResult
ผลการกรองของสินทรัพย์
คุณลักษณะ
สถานะการควบคุมของสินทรัพย์ สามารถเป็น MODERATION_STATE_REVIEWING หรือ MODERATION_STATE_REJECTED หรือ MODERATION_STATE_APPROVED
Operation
ทรัพยากรนี้เป็นตัวแทนของการดำเนินงานเวลานานซึ่งเป็นผลมาจากการโทร API เครือข่าย
คุณลักษณะ
หาก false การดำเนินการยังคงดำเนินอยู่ หาก true การดำเนินการเสร็จสิ้น
แบบผิดพลาดที่มีเหตุผลอธิบายสถานะข้อผิดพลาด
ประกอบด้วยข้อความซีรีเซอร์แบบสุ่มที่มี @type ที่อธิบายประเภทของข้อความซีรีเซอร์
เส้นทางทรัพยากรที่ได้รับการกำหนด รูปแบบปกติคือ operations/{operation_id}
ประกอบด้วยข้อความซีรีเซอร์แบบสุ่มที่มี @type ที่อธิบายประเภทของข้อความซีรีเซอร์
Preview
การดูตัวอย่างสินทรัพย์
คุณลักษณะ
ข้อความที่แสดงตัวอย่างสําหรับสินทรัพย์
เส้นทางสร้างตัวอย่าง
SocialLink
ลิงค์สื่อสังคมออนไลน์สำหร
คุณลักษณะ
ศูนย์กลางครีเอเตอร์
เชื่อมโยงเชื่อมโยงโดยปกติรหัสชื่อของวัตถุ twitchSocialLink จะต้องเป็นรูปแบบ https://twitch.tv/your-channel
Status
แบบผิดพลาดที่มีเหตุผลอธิบายสถานะข้อผิดพลาด
คุณลักษณะ
รหัสสถานะ HTTP
รายการข้อความที่มีรายละเอียดข้อผิดพลาด
ข้อความผิดพลาด