Roblox'un varlıklarını Stüdyo dışında aramak için Yaratıcı Mağaza API'sine erişebilirsiniz. Stüdyo varlıklarını, örneğin ızgaralar, modeller ve sesler sorgulamak için Yaratıcı Mağaza API'sini kullanın ve Pazaryeri varlıklarını sorgulamak için Pazaryeri API'sini kullanın.
Her API, belirli bir katalog için bir URL ve özel arama parametreleri gerektirir. Eğer hem URL hem de parametreler geçerliyse, API aramanızın sonuçlarını JSON formatında döndürür.
Yaratıcı Mağaza API
Yaratıcı Mağaza API'sine arama yapmak için çağrılar hakkında bilgi için Açık Bulut referansı'ndaki Araç Kutusu Servisi'ne bakın.
Pazaryeri API
Aşağıdaki URL'yi kullanarak Pazaryeri'ndeki avatar öğelerini sorgulayabilirsiniz: `https://catalog.roblox.com/v1/search/items/details?[params]``
Aramanızı özelleştirmek için [params] kısmını uygun sorgu parametreleri ile değiştirebilirsiniz.
Sorgu parametreleri
Belirli bir URL'ye bir dizi parametre ve değeri ekleyerek arama parametrelerini belirtebilirsiniz; her biri & ile ayrılır.
Pazaryeri'ni sorgulamak için aşağıdaki parametreleri kullanın:
| Parametre | Tür | Seçenekler ve Değerler |
|---|---|---|
| Kategori | byte | 0 = Öne Çıkan 1 = Hepsi 2 = Koleksiyonlar 3 = Kıyafetler 4 = Vücut Parçaları 5 = Eşyalar 11 = Aksesuarlar 12 = Avatar Animasyonları 13 = Topluluk Yaratımları |
| Yaratıcı Türü | byte | 1 = Kullanıcı 2 = Grup Yaratıcı Türü kullanarak yapılan sorgular ayrıca Yaratıcı Hedef ID'si parametresini de gerektirir. |
| Yaratıcı Hedef ID'si | long | Verilen Yaratıcı Türüne bağlı olarak kullanıcı veya grup ID'si. Yaratıcı Hedef ID'si kullanan sorgular ayrıca Yaratıcı Türü parametresini de gerektirir. |
| Yaratıcı Adı | string | Yaratıcı adı ile arama yapın. Eğer Enum.YaratıcıTürü sağlanmazsa, arama yalnızca kullanıcılar için yapılır. |
| İmleç | string | Her arama yanıtında, bir sonraki sayfa varsa nextPageCursor ve bir önceki sayfa varsa previousPageCursor bulunur. Sonraki sorgunuzda sonuçların bir sonraki veya bir önceki sayfasını almak için bu değerlerden birini İmleç parametresinde geçin. İmleç geçerli ise diğer sorgu parametreleri aynı kalmalıdır. |
| Türler | byte | Arama için türü belirtir. Türler üzerinde filtreleme yapmanın önerilen yolu, bir katalog sayfasının URL'si ile eşleşmektir. 1 = Kasaba ve Şehir 2 = Ortaçağ 3 = Bilim Kurgu 4 = Savaş 5 = Korku 6 = Donanma 7 = Macera 8 = Spor 9 = Komedi 10 = Vahşi Batı 11 = Askeri 13 = İnşaat 14 = FPS 15 = RPG |
| Anahtar Kelime | string | Standart anahtar kelime araması. |
| Sınır | int | Dönüş yapılacak sonuç sayısı. Değerler şu anda 10, 28 ve 30 ile sınırlıdır. |
| MaxFiyat | int | Sorgudaki öğelerin maksimum fiyatı (Robux cinsinden). |
| MinFiyat | int | Sorgudaki öğelerin minimum fiyatı (Robux cinsinden). |
| Sıralama Toplamı | byte | 1 = Son Gün 3 = Geçen Hafta 4 = Geçen Ay 5 = Tüm Zamanlar |
| Sıralama Türü | byte | 0 = Alaka (Varsayılan) 1 = Favori 2 = Satışlar 3 = Güncelleme 4 = FiyatYükselen 5 = FiyatDüşen |
| Alt Kategori | byte | 0 = Öne Çıkan 1 = Hepsi 2 = Koleksiyonlar 3 = Kıyafetler 4 = Vücut Parçaları 5 = Eşyalar 9 = Şapkalar 10 = Yüzler 12 = Gömlekler 13 = Ti-shirtler 14 = Pantolonlar 15 = Başlar 19 = Aksesuarlar 20 = Saç Aksesuarları 21 = Yüz Aksesuarları 22 = Boyun Aksesuarları 23 = Omuz Aksesuarları 24 = Ön Aksesuarları 25 = Arka Aksesuarlar 26 = Bel Aksesuarları 27 = Avatar Animasyonları 37 = Paketler 38 = Animasyon Paketleri 39 = Emote Animasyonları 40 = Topluluk Yaratımları 41 = Yakın Dövüş 42 = Menzilli 43 = Patlayıcı 44 = Güçlendirme 45 = Navigasyon 46 = Müzikal 47 = Sosyal 48 = İnşaat 49 = Taşıma 54 = Baş Aksesuarları 55 = Klasik Ti-shirtler 56 = Klasik Gömlekler 57 = Klasik Pantolonlar 58 = Ti-shirt Aksesuarları 59 = Gömlek Aksesuarları 60 = Pantolon Aksesuarları 61 = Ceket Aksesuarları 62 = Süveter Aksesuarları 63 = Şort Aksesuarları 64 = Ayakkabı Paketleri 65 = Elbise Etek Aksesuarları 66 = Dinamik Başlar |
Aşağıdaki URL, Roblox tarafından oluşturulan "Aksesuarlar" kategorisindeki "Eşyalar" arasında tüm zamanlar ("Sıralama Toplamı") ve alaka düzeyine ("Sıralama Türü") göre sıralanmış ilk 10 öğeyi arayacaktır:
Yanıt alanları
API yanıtları JSON formatında döner. Yanıt, data anahtarında varlık detaylarını aşağıdaki alanlarla sağlar:
| Alan | Açıklama |
|---|---|
| varlıkTürü | Aşağıdaki varlık türü değerlerinden biri (öğe bir varlık ise yalnızca döndürülür). 2 = Ti-shirt 8 = Şapka 11 = Gömlek 12 = Pantolon 17 = Baş 18 = Yüz 19 = Eşya 25 = Kollar 26 = Bacaklar 27 = Gövde 28 = Sağ Kol 29 = Sol Kol 30 = Sol Bacak 31 = Sağ Bacak 41 = Saç Aksesuarı 42 = Yüz Aksesuarı 43 = Boyun Aksesuarı 44 = Omuz Aksesuarı 45 = Ön Aksesuarı 46 = Arka Aksesuarı 47 = Bel Aksesuarı 48 = Tırmanma Animasyonu 49 = Ölüm Animasyonu 50 = Düşme Animasyonu 51 = Bekleme Animasyonu 52 = Zıplama Animasyonu 53 = Koşma Animasyonu 54 = Yüzme Animasyonu 55 = Yürüyüş Animasyonu 56 = Poz Animasyonu 61 = Emote Animasyonu |
| paketTürü | Paket türü kimliği (öğe bir paket ise yalnızca döndürülür). Olası değerler Vücut Parçaları ve Avatar Animasyonlarıdır. |
| yaratıcıAdı | Yaratıcının adı. |
| yaratıcıHedefID'si | Yaratıcının ID'si. |
| yaratıcıTürü | Öğenin yaratıcı türü. |
| açıklama | Öğenin açıklaması. |
| favoriSayısı | Bir öğenin favori sayısı. |
| Türler | Öğenin türlerinin listesi. Olası değerler arasında Hepsi, Eğitim, Korkutucu, Kasaba ve Şehir, Savaş, Komik, Fantastik, Macera, Bilim Kurgu, Korsan, FPS, RPG, Spor, Ninja, ve Vahşi Batı bulunur. |
| id | Öğenin ID'si. |
| öğeKısıtlamaları | Öğenin kısıtlamalarının listesi. Olası değerler arasında OnÜçAltı, SınırlıÖzel, Sınırlı, ve Rthro bulunur. |
| öğeDurumu | Öğenin durum bayraklarının listesi. Olası değerler arasında Yeni, Satış, XboxÖzel, AmazonÖzel, GooglePlayÖzel, IosÖzel, ve SatışZamanlayıcı bulunur. |
| öğeTürü | Öğenin türü. Olası değerler Varlık veya Paket'tir. |
| enDüşükFiyat | Öğenin en düşük yeniden satış fiyatı (öğe satılabilir ise yalnızca döndürülür). |
| isim | Öğenin adı. |
| fiyat | Öğenin liste fiyatı (öğenin satılabilir olması durumunda mevcut fiyat farklılık gösterebilir). |
| fiyatDurumu | Satışta olmayan bir öğenin fiyat durumudur. Olası değerler Ücretsiz, SatıştaDeğil, veya YenidenSatıcıYok'tur. |
| satınAlmaSayısı | Bir öğenin satın alma sayısı. |
| tüketimİçinMevcutBirimler | Sınırlı özel bir öğenin tüketimi için mevcut birimi. |
Aşağıda tek bir öğe için beklenen bir döndürme çıktısının örneği verilmiştir:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Huzursuz Ruhlar Bandanası",
"description":"Bu bandana, hayaletlerle uyum sağlamanıza yardımcı olmaz, ama en azından stil sahibi olursunuz.",
"productId":41270974,
"genres":[
"Korkutucu",
"Macera"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"Kullanıcı",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}