Puoi cercare le risorse di Roblox al di fuori di Studio accedendo all'API Creator Store.Usa l'Creator Store API per interrogare le risorse di Studio, come mesh, modelli e audio/suono, e l'API del Marketplace per interrogare le risorse dell'avatar sul 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 Cercare.
API del Creator Store
Per informazioni su come effettuare chiamate all'API Creator Store per la Cercare, vedi Servizio Toolbox nel Open Cloud reference.
API del mercato
Puoi interrogare gli oggetti dell'avatar dal Marketplace utilizzando il seguente URL: https://catalog.roblox.com/v1/search/items/details?[params]
Puoi sostituire con i parametri di query appropriati per personalizzare la tua Cercare.
Parametri di query
Puoi specificare i parametri di ricerca aggiungendo una serie di parametri e valori all'URL, ciascuno separato da un &.
Usa i seguenti parametri per interrogare il Marketplace:
| Parametro | Tipo | Opzioni e valori |
|---|---|---|
| Categoria | byte | = In primo piano = Tutti = Oggetti da collezione > = Abbigliamento > = Parti del corpo > = Accessori > = Animazioni di Avatar > = Creazioni della comunità > = Animazioni di Avatar della comunità |
| Tipo di creatore | byte | 1 = Utente 2 = Gruppo |
| NomeCreatore | stringa | Cerca per nome del creatore. Se non viene fornito Enum.CreatorType, la ricerca è solo per gli utenti. |
| ID Target Creatore | lungo | L'ID utente o gruppo a seconda del CreatorType fornito. |
| Curatore | stringa | Ogni risposta di ricerca contiene un nextPageCursor se esiste una pagina successiva e un previousPageCursor se esiste una pagina precedente.Passa uno di questi valori nel parametro Cursor della tua prossima query per ottenere la pagina successiva o precedente dei risultati.Il cursore è valido se gli altri parametri di query rimangono gli stessi. |
| Generi | byte | Specifica il genere per la Cercare.L'approccio raccomandato per filtrare sui generi è abbinare l'URL di una pagina del catalogo.1 = TownAndCity 2 = Medieval 3 = SciFi 4 = Combattimento 5 = Horror 6 = Navale 7 = Avventura 8 = Sport 9 = Comedy 10 = Western 11 = Militare 13 = Costruzione 14 = FPS 15 = RPG |
| Parola chiave | stringa | Cercaredi parole chiave standard. |
| Limite | int | Numero di risultati da Riportare. I valori sono attualmente limitati a 10, 28 e 30. |
| Prezzo massimo | int | Il prezzo massimo in Robux degli oggetti nella Query. |
| Prezzo minimo | int | Il prezzo minimo in Robux degli oggetti nella Query. |
| Ordina aggregazione | byte | 1 = Giorno Passato 3 = Settimana Passata 4 = Mese Passato 5 = Tutto il Tempo |
| Tipo di ordinamento | byte | = Rilevanza (Predefinita) = Preferito = Vendite = Aggiornato = Prezzo Ascendente = PrezzoDescendente = PrezzoAscendente |
| Sottocategoria | byte | English: Italiano Documentazione dell'API English: No support Italian: Italian: Documentazione dell'API Italian: |
L'URL seguente cercherà i primi 10 oggetti "Gear" in "Accessori" ordinati per tempo ("SortAggregation") e rilevanza ("SortType") creati da Roblox ("CreatorTargetId"):
https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&SortType=0&SortAggregation=5&Limit=10
Campi di risposta
Le risposte API vengono restituite in formato JSON. La risposta fornisce dettagli delle risorse nell'area data della chiave utilizzando i seguenti campi:
| Campo | Descrizione |
|---|---|
| assetType | Uno dei seguenti valori del tipo di risorsa (restituito solo se l'elemento è una risorsa). = T-Shirt = Cappello = Camicia = Pantaloni = Cappello = Orologio = Orologio = Orologio = Orologio > = Orologio > = Orologio > = Orologio > = Orologio > = Orologio > = Orologio > = Orologio > = Orologio > = Animazione di esecuzione > = Animazione di esecuzione > = Animazione di esecuzione > = Animazione di esecuzione > = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione = Animazione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecuzione di esecazione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecazione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecuzione di esecizione di esecuzione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecizione di esecazione di esecizione di esecazione di esecazione di esecizione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione di esecazione |
| bundleType | L'ID del tipo di bundle (restituito solo se l'elemento è un pacchetto). I valori possibili sono BodyParts e AvatarAnimations. |
| creatorName | Il nome del Creatore. |
| creatorTargetId | L'ID del Creatore. |
| tipo creatore | Il inserisci / scrividi creatore dell'Articolo. |
| descrizione | La Descrizionedell'articolo. |
| numberi preferiti | Il conteggio preferito di un Articolo. |
| generi | Elenco dei generi dell'Articolo.I valori possibili includono All , Tutorial , Scary , TownAndCity , War , Funny , Fantasy , Adventure , SciFi , Pirate , FPS , RPG , Sports , Ninja , e WildWest. |
| id | L'ID dell'Articolo. |
| restrizioni dell'oggetto | Elenco delle restrizioni dell'Articolo. I valori possibili includono ThirteenPlus , LimitedUnique , Limited e Rthro . |
| status dell'oggetto | Elenco delle bandiere di stato dell'Articolo.I valori possibili includono New , Sale , XboxExclusive , AmazonExclusive , GooglePlayExclusive , IosExclusive , e SaleTimer . |
| type di oggetto | Il inserisci / scrividi oggetto. I valori possibili sono Asset o Bundle . |
| prezzo più basso | Il prezzo di rivendita più basso dell'articolo (restituito solo se l'articolo è rivendibile). |
| nome | Il nome dell'elemento. |
| prezzo | Il prezzo di elenco dell'articolo (il prezzo attuale potrebbe essere diverso se l'articolo è riutilizzabile). |
| prezzoStatus | Lo stato di prezzo di un oggetto che non è in Vendita. I valori possibili sono Free , OffSale o NoResellers . |
| purchaseCount | Il conteggio degli acquisti di un Articolo. |
| unità disponibili per il consumo | L'unità disponibile per il consumo di un Articolounico limitato. |
Il seguente è un esempio di output di restituzione previsto per un singolo Articolo:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Restless Souls Bandana",
"description":"This bandana won't help you blend in with ghosts, but at least you'll be stylish.",
"productId":41270974,
"genres":[
"Scary",
"Adventure"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"User",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}