Bạn có thể tìm kiếm các tài nguyên của Roblox ngoài Studio bằng cách truy cập vào API Creator Store. Sử dụng Creator Store API để truy vấn tài sản trong Studio, chẳng hạn như mesh, mô hình và âm thanh, và Marketplace API để truy vấn tài sản avatar trên Marketplace.
Mỗi API yêu cầu một URL và các tham số tìm kiếm tùy chỉnh cho danh mục cụ thể đó. Nếu cả URL và các tham số đều hợp lệ, API sẽ trả về một định dạng JSON với kết quả của tìm kiếm của bạn.
Creator Store API
Để biết thêm thông tin về việc thực hiện các cuộc gọi tới Creator Store API để tìm kiếm, hãy xem Toolbox Service trong tài liệu tham khảo Open Cloud.
Marketplace API
Bạn có thể truy vấn các mặt hàng avatar từ Marketplace bằng cách sử dụng URL sau: https://catalog.roblox.com/v1/search/items/details?[params]
Bạn có thể thay thế [params] bằng các tham số truy vấn thích hợp để tùy chỉnh tìm kiếm của mình.
Các tham số truy vấn
Bạn có thể chỉ định các tham số tìm kiếm bằng cách thêm một loạt các tham số và giá trị vào URL, mỗi cái được phân tách bằng một dấu &.
Sử dụng các tham số sau để truy vấn Marketplace:
| Tham số | Loại | Tùy chọn và Giá trị |
|---|---|---|
| Danh mục | byte | 0 = Nổi bật 1 = Tất cả 2 = Đồ sưu tập 3 = Thời trang 4 = Bộ phận cơ thể 5 = Trang bị 11 = Phụ kiện 12 = Hoạt ảnh avatar 13 = Tác phẩm cộng đồng |
| Loại Người Tạo | byte | 1 = Người dùng 2 = Nhóm Các truy vấn sử dụng Loại Người Tạo cũng yêu cầu tham số CreatorTargetId. |
| ID Người Tạo | long | ID của người dùng hoặc nhóm phụ thuộc vào Loại Người Tạo được cung cấp. Các truy vấn sử dụng ID Người Tạo cũng yêu cầu tham số Loại Người Tạo. |
| Tên Người Tạo | string | Tìm kiếm theo tên người tạo. Nếu không cung cấp Enum.CreatorType, thì tìm kiếm chỉ dành cho người dùng. |
| Con trỏ | string | Mỗi phản hồi tìm kiếm chứa một nextPageCursor nếu có trang tiếp theo và previousPageCursor nếu có trang trước. Truyền một trong những giá trị này vào tham số Con trỏ của truy vấn tiếp theo để lấy trang kết quả tiếp theo hoặc trước. Con trỏ hợp lệ nếu các tham số truy vấn khác vẫn giữ nguyên. |
| Thể loại | byte | Xác định thể loại cho tìm kiếm. Cách tiếp cận được khuyến nghị để lọc theo thể loại là khớp với URL của một trang catalog. 1 = Thị trấn và Thành phố 2 = Trung cổ 3 = Khoa học viễn tưởng 4 = Đánh nhau 5 = Kinh dị 6 = Hải quân 7 = Phiêu lưu 8 = Thể thao 9 = Hài hước 10 = Miền Tây 11 = Quân đội 13 = Xây dựng 14 = FPS 15 = RPG |
| Từ khoá | string | Tìm kiếm từ khoá tiêu chuẩn. |
| Giới hạn | int | Số kết quả cần trả về. Các giá trị hiện tại được giới hạn ở 10, 28 và 30. |
| Giá Tối Đa | int | Giá tối đa bằng Robux của các mặt hàng trong truy vấn. |
| Giá Tối Thiểu | int | Giá tối thiểu bằng Robux của các mặt hàng trong truy vấn. |
| Sắp xếp Tập Hợp | byte | 1 = Ngày trước 3 = Tuần trước 4 = Tháng trước 5 = Tất cả thời gian |
| Loại Sắp Xếp | byte | 0 = Liên quan (Mặc định) 1 = Được yêu thích 2 = Bán hàng 3 = Cập nhật 4 = Giá Tăng dần 5 = Giá Giảm dần |
| Danh mục phụ | byte | 0 = Nổi bật 1 = Tất cả 2 = Đồ sưu tập 3 = Thời trang 4 = Bộ phận cơ thể 5 = Trang bị 9 = Mũ 10 = Mặt 12 = Áo sơ mi 13 = Áo phông 14 = Quần 15 = Đầu 19 = Phụ kiện 20 = Phụ kiện tóc 21 = Phụ kiện mặt 22 = Phụ kiện cổ 23 = Phụ kiện vai 24 = Phụ kiện trước 25 = Phụ kiện sau 26 = Phụ kiện eo 27 = Hoạt ảnh avatar 37 = Gói 38 = Gói hoạt ảnh 39 = Hoạt ảnh biểu cảm 40 = Tác phẩm cộng đồng 41 = Cận chiến 42 = Tầm xa 43 = Nổ 44 = Tăng cường 45 = Điều hướng 46 = Âm nhạc 47 = Xã hội 48 = Xây dựng 49 = Vận chuyển 54 = Phụ kiện đầu 55 = Áo phông cổ điển 56 = Áo cổ điển 57 = Quần cổ điển 58 = Phụ kiện áo phông 59 = Phụ kiện áo 60 = Phụ kiện quần 61 = Phụ kiện áo khoác 62 = Phụ kiện áo len 63 = Phụ kiện quần sooc 64 = Gói giày 65 = Phụ kiện váy 66 = Đầu động |
URL sau sẽ tìm kiếm 10 mặt hàng "Gear" đầu tiên trong "Phụ kiện" được sắp xếp theo tất cả thời gian ("Sắp xếp Tập Hợp") và liên quan ("Loại Sắp Xếp") do Roblox tạo ("ID Người Tạo" và "Loại Người Tạo"):
https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&CreatorType=User&SortType=0&SortAggregation=5&Limit=10
Các trường phản hồi
Các phản hồi API trả về dưới định dạng JSON. Phản hồi cung cấp chi tiết về tài sản trong khóa data bằng các trường sau:
| Trường | Mô tả |
|---|---|
| assetType | Một trong các giá trị loại tài sản sau (chỉ trả về nếu mặt hàng là tài sản). 2 = Áo phông 8 = Mũ 11 = Áo 12 = Quần 17 = Đầu 18 = Mặt 19 = Trang bị 25 = Cánh tay 26 = Chân 27 = Thân 28 = Cánh tay phải 29 = Cánh tay trái 30 = Chân trái 31 = Chân phải 41 = Phụ kiện tóc 42 = Phụ kiện mặt 43 = Phụ kiện cổ 44 = Phụ kiện vai 45 = Phụ kiện trước 46 = Phụ kiện sau 47 = Phụ kiện eo 48 = Hoạt ảnh leo trèo 49 = Hoạt ảnh chết 50 = Hoạt ảnh ngã 51 = Hoạt ảnh đứng yên 52 = Hoạt ảnh nhảy 53 = Hoạt ảnh chạy 54 = Hoạt ảnh bơi 55 = Hoạt ảnh đi bộ 56 = Hoạt ảnh tạo dáng 61 = Hoạt ảnh biểu cảm |
| bundleType | ID loại gói (chỉ trả về nếu mặt hàng là một gói). Các giá trị có thể là BodyParts và AvatarAnimations. |
| creatorName | Tên của người tạo. |
| creatorTargetId | ID của người tạo. |
| creatorType | Loại người tạo của mặt hàng. |
| description | Mô tả của mặt hàng. |
| favoriteCount | Số lượng yêu thích của một mặt hàng. |
| genres | Danh sách các thể loại của mặt hàng. Các giá trị có thể bao gồm Tất cả, Hướng dẫn, Kinh dị, Thị trấn và Thành phố, Chiến tranh, Hài hước, Giả tưởng, Phiêu lưu, Khoa học viễn tưởng, Cướp biển, FPS, RPG, Thể thao, Ninja, và Miền Tây hoang dã. |
| id | ID của mặt hàng. |
| itemRestrictions | Danh sách các hạn chế của mặt hàng. Các giá trị có thể bao gồm ThirteenPlus, LimitedUnique, Limited, và Rthro. |
| itemStatus | Danh sách các cờ trạng thái của mặt hàng. Các giá trị có thể bao gồm Mới, Bán hàng, XboxExclusive, AmazonExclusive, GooglePlayExclusive, IosExclusive, và SaleTimer. |
| itemType | Loại mặt hàng. Các giá trị có thể là Tài sản hoặc Gói. |
| lowestPrice | Giá thấp nhất của mặt hàng do người bán lại (chỉ trả về nếu mặt hàng có thể bán lại). |
| name | Tên của mặt hàng. |
| price | Giá niêm yết của mặt hàng (giá hiện tại có thể khác nếu mặt hàng có thể bán lại). |
| priceStatus | Trạng thái giá của một mặt hàng không được bán. Các giá trị có thể là Miễn phí, Ngừng bán, hoặc Không có người bán lại. |
| purchaseCount | Số lần mua của một mặt hàng. |
| unitsAvailableForConsumption | Số lượng có sẵn để tiêu thụ của một mặt hàng độc nhất giới hạn. |
Dưới đây là một ví dụ về đầu ra mong đợi cho một mặt hàng đơn lẻ:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Tài sản",
"assetType":42,
"name":"Khăn Bandana Linh Hồn Không Nghỉ",
"description":"Khăn bandana này sẽ không giúp bạn hòa nhập với ma, nhưng ít nhất bạn sẽ phong cách.",
"productId":41270974,
"genres":[
"Kinh dị",
"Phiêu lưu"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"Người dùng",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}