Puoi cercare gli asset di Roblox al di fuori di Studio accedendo all'API del Creator Store. Utilizza l'API del Creator Store per interrogare gli asset di Studio, come mesh, modelli e audio, e l'API del Marketplace per interrogare gli asset avatar nel Marketplace.
Ogni API richiede un URL e parametri di ricerca personalizzati per quel catalogo specifico. Se sia l'URL che i parametri sono validi, l'API restituisce un formato JSON con i risultati della tua ricerca.
API del Creator Store
Per informazioni su come effettuare chiamate all'API del Creator Store per la ricerca, consulta il servizio Toolbox nella riferimento Open Cloud.
API del Marketplace
Puoi interrogare gli oggetti avatar dal Marketplace utilizzando il seguente URL: https://catalog.roblox.com/v1/search/items/details?[params]
Puoi sostituire [params] con i parametri di query appropriati per personalizzare la tua ricerca.
Parametri di query
Puoi specificare i parametri di ricerca aggiungendo una serie di parametri e valori all'URL, ciascuno separato da un &.
Utilizza i seguenti parametri per interrogare il Marketplace:
| Parametro | Tipo | Opzioni e Valori |
|---|---|---|
| Categoria | byte | 0 = In primo piano 1 = Tutti 2 = Collezionabili 3 = Abbigliamento 4 = Corpo 5 = Attrezzature 11 = Accessori 12 = AnimazioniAvatar 13 = CreazioniCommunity |
| CreatorType | byte | 1 = Utente 2 = Gruppo Le query che utilizzano CreatorType richiedono anche il parametro CreatorTargetId. |
| CreatorTargetId | long | L'ID dell'utente o del gruppo a seconda del CreatorType fornito. Le query che utilizzano CreatorTargetId richiedono anche il parametro CreatorType. |
| CreatorName | string | Cerca per nome del creatore. Se Enum.CreatorType non è fornito, la ricerca è solo per utenti. |
| Cursor | string | Ogni risposta di ricerca contiene un nextPageCursor se c'è una pagina successiva e previousPageCursor se c'è una pagina precedente. Passa uno di questi valori nel parametro Cursor della tua prossima query per ottenere la pagina successiva o precedente di risultati. Il cursore è valido se gli altri parametri di query rimangono gli stessi. |
| Generi | byte | Specifica il genere per la ricerca. L'approccio consigliato per filtrare sui generi è abbinare l'URL di una pagina di catalogo. 1 = Città e Paesi 2 = Medievale 3 = Fantascienza 4 = Combattimento 5 = Horror 6 = Navale 7 = Avventura 8 = Sport 9 = Commedia 10 = Western 11 = Militare 13 = Costruzione 14 = FPS 15 = RPG |
| ParolaChiave | string | Ricerca per parola chiave standard. |
| Limite | int | Numero di risultati da restituire. I valori sono attualmente limitati a 10, 28 e 30. |
| PrezzoMassimo | int | Il prezzo massimo in Robux degli oggetti nella query. |
| PrezzoMinimo | int | Il prezzo minimo in Robux degli oggetti nella query. |
| SortAggregation | byte | 1 = Ultimo giorno 3 = Ultima settimana 4 = Ultimo mese 5 = Tutto il tempo |
| SortType | byte | 0 = Rilevanza (Predefinito) 1 = Preferito 2 = Vendite 3 = Aggiornato 4 = PrezzoAsc 5 = PrezzoDesc |
| Sottocategoria | byte | 0 = In primo piano 1 = Tutti 2 = Collezionabili 3 = Abbigliamento 4 = Corpo 5 = Attrezzature 9 = Cappelli 10 = Faccie 12 = Camicie 13 = TShirt 14 = Pantaloni 15 = Teste 19 = Accessori 20 = Accessori per capelli 21 = Accessori per la faccia 22 = Accessori per il collo 23 = Accessori per la spalla 24 = Accessori frontali 25 = Accessori per la schiena 26 = Accessori in vita 27 = AnimazioniAvatar 37 = Insieme 38 = Insiemi di animazione 39 = AnimazioniEmote 40 = CreazioniCommunity 41 = Corpo a corpo 42 = A distanza 43 = Esplosivo 44 = Potenziamento 45 = Navigazione 46 = Musicale 47 = Sociale 48 = Costruzione 49 = Trasporto 54 = Accessori per capelli 55 = TShirtClassici 56 = CamicieClassiche 57 = PantaloniClassici 58 = Accessori per TShirt 59 = Accessori per camicie 60 = Accessori per pantaloni 61 = Accessori per giacche 62 = Accessori per maglioni 63 = Accessori per pantaloni corti 64 = Insiemi di scarpe 65 = Accessori per gonne e vestiti 66 = Teste dinamiche |
Il seguente URL cercherà i primi 10 articoli "Attrezzature" in "Accessori" ordinati per tutto il tempo ("SortAggregation") e rilevanza ("SortType") creati da Roblox ("CreatorTargetId" e "CreatorType"):
https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&CreatorType=User&SortType=0&SortAggregation=5&Limit=10
Campi di risposta
Le risposte delle API restituiscono un formato JSON. La risposta fornisce dettagli sugli asset nella chiave data utilizzando i seguenti campi:
| Campo | Descrizione |
|---|---|
| assetType | Uno dei seguenti valori di tipo di asset (restituito solo se l'oggetto è un asset). 2 = Maglietta 8 = Cappello 11 = Camicia 12 = Pantaloni 17 = Testa 18 = Faccia 19 = Attrezzatura 25 = Braccia 26 = Gambe 27 = Torso 28 = BraccioDestro 29 = BraccioSinistro 30 = GambaSinistra 31 = GambaDestra 41 = AccessorioCapelli 42 = AccessorioFaccia 43 = AccessorioCollo 44 = AccessorioSpalla 45 = AccessorioFrontale 46 = AccessorioPosteriore 47 = AccessorioVita 48 = AnimazioneScala 49 = AnimazioneMorte 50 = AnimazioneCaduta 51 = AnimazioneInAttesa 52 = AnimazioneSalto 53 = AnimazioneCorsa 54 = AnimazioneNuoto 55 = AnimazioneCamminata 56 = AnimazionePosa 61 = AnimazioneEmote |
| bundleType | Il tipo di ID del bundle (restituito solo se l'oggetto è un bundle). I valori possibili sono BodyParts e AnimazioniAvatar. |
| creatorName | Il nome del creatore. |
| creatorTargetId | L'ID del creatore. |
| creatorType | Il tipo del creatore dell'oggetto. |
| description | La descrizione dell'oggetto. |
| favoriteCount | Il conteggio dei preferiti di un oggetto. |
| genres | Elenco dei generi dell'oggetto. I valori possibili includono Tutti, Tutorial, Spaventoso, Città e Paesi, Guerra, Divertente, Fantasia, Avventura, Fantascienza, Pirata, FPS, RPG, Sport, Ninja, e FarWest. |
| id | L'ID dell'oggetto. |
| itemRestrictions | Elenco delle restrizioni dell'oggetto. I valori possibili includono ThirteenPlus, LimitedUnique, Limited, e Rthro. |
| itemStatus | Elenco dei flag di stato dell'oggetto. I valori possibili includono Nuovo, In vendita, Esclusivo Xbox, Esclusivo Amazon, Esclusivo GooglePlay, Esclusivo Ios, e TimerVendita. |
| itemType | Il tipo di oggetto. I valori possibili sono Asset o Bundle. |
| lowestPrice | Il prezzo minimo di rivendita dell'oggetto (restituito solo se l'oggetto è rivendibile). |
| name | Il nome dell'oggetto. |
| price | Il prezzo di listino dell'oggetto (il prezzo attuale può differire se l'oggetto è rivendibile). |
| priceStatus | Lo stato del prezzo di un oggetto che non è in vendita. I valori possibili sono Gratuito, NonInVendita, o NoRivenditori. |
| purchaseCount | Il conteggio degli acquisti di un oggetto. |
| unitsAvailableForConsumption | L'unità disponibile per il consumo di un oggetto limitato unico. |
Di seguito un esempio di output di ritorno atteso per un singolo oggetto:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Bandana Anime Inquieta",
"description":"Questa bandana non ti aiuterà a confonderti con i fantasmi, ma almeno sarai di stile.",
"productId":41270974,
"genres":[
"Spaventoso",
"Avventura"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"Utente",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}