Możesz wyszukiwać zasoby Roblox poza Studio, uzyskując dostęp do interfejsu API Sklepu Twórcy. Użyj API Sklepu Twórcy, aby zapytać o zasoby Studio, takie jak siatki, modele i audio, a także API Marketplace, aby zapytać o zasoby awatarów na Marketplace.
Każde API wymaga adresu URL i niestandardowych parametrów wyszukiwania dla danego katalogu. Jeśli zarówno adres URL, jak i parametry są poprawne, API zwraca wynik w formacie JSON z wynikami Twojego wyszukiwania.
API Sklepu Twórcy
Aby uzyskać informacje na temat wywołań do API Sklepu Twórcy w celu wyszukiwania, zobacz usługę Toolbox w referencji Open Cloud.
API Marketplace
Możesz zapytać o elementy awatara z Marketplace, używając następującego adresu URL: `https://catalog.roblox.com/v1/search/items/details?[params]``
Możesz zastąpić [params] odpowiednimi parametrami zapytania, aby dostosować swoje wyszukiwanie.
Parametry zapytania
Możesz określić parametry wyszukiwania, dodając szereg parametrów i wartości do adresu URL, każdy oddzielony znakiem &.
Użyj następujących parametrów do zapytań na Marketplace:
| Parametr | Typ | Opcje i Wartości |
|---|---|---|
| Kategoria | byte | 0 = Wyróżnione 1 = Wszystkie 2 = Kolekcjonerskie 3 = Ubrania 4 = CzęściCiała 5 = Sprzęt 11 = Akcesoria 12 = AnimacjeAwatara 13 = TworzeniaSpołeczności |
| TypTwórcy | byte | 1 = Użytkownik 2 = Grupa Zapytania używające TypTwórcy również wymagają parametru IdCelującegoTwórcy. |
| IdCelującegoTwórcy | long | ID użytkownika lub grupy w zależności od podanego TypuTwórcy. Zapytania używające IdCelującegoTwórcy również wymagają parametru TypTwórcy. |
| NazwaTwórcy | string | Wyszukiwanie według nazwy twórcy. Jeśli Enum.TypTwórcy nie jest podany, wyszukiwanie dotyczy tylko użytkowników. |
| Cursor | string | Każda odpowiedź na wyszukiwanie zawiera nextPageCursor, jeśli istnieje następna strona, oraz previousPageCursor, jeśli istnieje strona poprzednia. Przekaż którąkolwiek z tych wartości w parametrze Cursor swojego następnego zapytania, aby uzyskać następną lub poprzednią stronę wyników. Kursor jest ważny, jeśli pozostałe parametry zapytania pozostają takie same. |
| Gatunki | byte | Określa gatunek dla wyszukiwania. Zalecane podejście do filtrowania według gatunków to dopasowanie do adresu URL strony katalogu. 1 = Miejskie 2 = Średniowieczne 3 = SciFi 4 = Walki 5 = Horror 6 = Morski 7 = Przygoda 8 = Sport 9 = Komedia 10 = Western 11 = Wojskowe 13 = Budowanie 14 = FPS 15 = RPG |
| SłowoKluczowe | string | Standardowe wyszukiwanie słów kluczowych. |
| Limit | int | Liczba wyników do zwrócenia. Wartości są obecnie ograniczone do 10, 28 i 30. |
| MaxCena | int | Maksymalna cena w Robux za elementy w zapytaniu. |
| MinCena | int | Minimalna cena w Robux za elementy w zapytaniu. |
| SortowanieAgregacji | byte | 1 = OstatniDzień 3 = OstatniTydzień 4 = OstatniMiesiąc 5 = CałyCzas |
| TypSortowania | byte | 0 = Trafność (Domyślnie) 1 = Ulubione 2 = Sprzedaż 3 = Zaktualizowane 4 = CenaRosnąco 5 = CenaMalejąco |
| Podkategoria | byte | 0 = Wyróżnione 1 = Wszystkie 2 = Kolekcjonerskie 3 = Ubrania 4 = CzęściCiała 5 = Sprzęt 9 = Kapelusze 10 = Twarze 12 = Koszulki 13 = TShirty 14 = Spodnie 15 = Głowy 19 = Akcesoria 20 = AkcesoriaDoWłosów 21 = AkcesoriaDoTwarzy 22 = AkcesoriaNaSzyję 23 = AkcesoriaNaRamieniu 24 = AkcesoriaNaPrzodzie 25 = AkcesoriaNaPlecach 26 = AkcesoriaWPas 27 = AnimacjeAwatara 37 = Zestawy 38 = ZestawyAnimacji 39 = AnimacjeEmocji 40 = TworzeniaSpołeczności 41 = Melee 42 = Zasięgowe 43 = Eksplozywne 44 = Wzmocnienia 45 = Nawigacyjne 46 = Muzyczne 47 = Społeczne 48 = Budowanie 49 = Transport 54 = AkcesoriaDoGłowy 55 = KoszulkiKlasyczne 56 = KoszulkiKlasyczne 57 = SpodnieKlasyczne 58 = AkcesoriaTShirtów 59 = AkcesoriaDoKoszulek 60 = AkcesoriaDoSpodni 61 = AkcesoriaDoKurtki 62 = AkcesoriaDoSwetra 63 = AkcesoriaDoSzortów 64 = ZestawyButów 65 = AkcesoriaSukni 66 = DynamiczneGłowy |
Poniższy adres URL będzie wyszukiwał pierwsze 10 "elementów sprzętu" w "Akcesoria" uporządkowanych według całego czasu ("SortowanieAgregacji") i trafności ("TypSortowania") stworzonych przez Roblox ("IdCelującegoTwórcy" i "TypTwórcy"):
Pola odpowiedzi
Odpowiedzi API zwracane są w formacie JSON. Odpowiedź zawiera szczegóły zasobów w kluczu data z następującymi polami:
| Pole | Opis |
|---|---|
| typZasobu | Jedna z następujących wartości typu zasobu (zwracana tylko, jeśli element jest zasobem). 2 = T-Shirt 8 = Kapelusz 11 = Koszulka 12 = Spodnie 17 = Głowa 18 = Twarz 19 = Sprzęt 25 = Ręce 26 = Nogi 27 = Tułów 28 = PrawaRęka 29 = LewaRęka 30 = LewaNoga 31 = PrawaNoga 41 = AkcesoriumDoWłosów 42 = AkcesoriumDoTwarzy 43 = AkcesoriumNaSzyję 44 = AkcesoriumNaRamieniu 45 = AkcesoriumNaPrzodzie 46 = AkcesoriumNaPlecach 47 = AkcesoriumWPas 48 = AnimacjaWspinaczki 49 = AnimacjaŚmierci 50 = AnimacjaUpadku 51 = AnimacjaBezczynności 52 = AnimacjaSkoku 53 = AnimacjaBiegu 54 = AnimacjaPływania 55 = AnimacjaChodzenia 56 = AnimacjaPozowania 61 = AnimacjaEmocji |
| typZestawu | ID typu zestawu (zwracana tylko, jeśli element jest zestawem). Możliwe wartości to CzęściCiała i AnimacjeAwatara. |
| nazwaTwórcy | Nazwa twórcy. |
| idCelującegoTwórcy | ID twórcy. |
| typTwórcy | Typ twórcy elementu. |
| opis | Opis elementu. |
| liczbaUlubionych | Liczba ulubionych elementu. |
| gatunki | Lista gatunków elementu. Możliwe wartości to Wszystkie, Wykład, Straszny, Miejskie, Wojna, Zabawne, Fantastyczne, Przygoda, SciFi, Pirackie, FPS, RPG, Sportowe, Ninja oraz DzikimZachodzie. |
| id | ID elementu. |
| ograniczeniaElementu | Lista ograniczeń elementu. Możliwe wartości to OsiemnaściePlus, LimitowaneUnikalne, Limitowane oraz Rthro. |
| statusElementu | Lista flag statusu elementu. Możliwe wartości to Nowy, Sprzedaż, EkskluzywneXbox, EkskluzywneAmazon, EkskluzywneGooglePlay, EkskluzywneIos oraz ZegarSprzedaży. |
| typElementu | Typ elementu. Możliwe wartości to Zasób lub Zestaw. |
| najniższaCena | Najniższa cena odsprzedaży elementu (zwracana tylko, jeśli element jest możliwy do odsprzedaży). |
| nazwa | Nazwa elementu. |
| cena | Cena oferty elementu (aktualna cena może się różnić, jeśli element jest możliwy do odsprzedaży). |
| statusCenowy | Status ceny elementu, który nie jest na sprzedaż. Możliwe wartości to Darmowy, Wycofany lub BrakOdsprzedawców. |
| liczbaZakupów | Liczba zakupów elementu. |
| jednostkiDostępneDoWykorzystania | Jednostka dostępna do wykorzystania dla unikalnego, limitowanego elementu. |
Poniżej znajduje się przykład oczekiwanej odpowiedzi zwrotnej dla jednego elementu:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Chusta Niespokojnych Dusz",
"description":"Ta chusta nie pomoże ci wmieszać się w tłum duchów, ale przynajmniej będziesz stylowy.",
"productId":41270974,
"genres":[
"Straszny",
"Przygoda"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"User",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}