Query di catalogo esterno

Puoi cercare le risorse di Roblox al di fuori di Studio accedendo all'API del catalogo esterno. Utilizza l'API di Creator Marketplace per interrogare le risorse di Studio, come mesh, modelli e audio e l'API di Marketplace per interrogare le risorse 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 ricerca

API di Creator Marketplace

È possibile interrogare gli elementi dal catalogo Creator Marketplace utilizzando il seguente URL: https://search.roblox.com/catalog/json?[params]

È possibile sostituire [params] con i parametri di query appropriati per personalizzare la ricerca.

Parametri di query

È possibile 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 catalogo di Creator Marketplace:

Il seguente URL cercherà 10 elementi nella sottocategoria "Modelli", ordinati secondo l'aggiornamento più recente.

https://search.roblox.com/catalog/json?Category=6&SortType=3&ResultsPerPage=10

Campi di risposta

Le risposte API vengono riportate in formato JSON. La risposta fornisce dettagli sulle attività con i seguenti campi primari:

Di seguito è riportato un esempio di risultato atteso per un singolo articolo:

{
    "AssetId": 3374795585,
    "Name": "Rat",
    "Description": "",
    "AbsoluteUrl": "https://www.roblox.com/catalog/3374795585/Rat",
    "Price": "",
    "Updated": "8 months ago",
    "Favorited": "80 times",
    "Sales": "1,613",
    "Remaining": "",
    "Creator": "ROBLOX",
    "CreatorAbsoluteUrl": "https://www.roblox.com/users/1/profile",
    "PrivateSales": "",
    "PriceView": 0,
    "BestPrice": "",
    "ContentRatingTypeID": 0,
    "IsServerSideThumbnailLookupInCatalogEnabled": true,
    "AudioUrl": null,
    "IsLargeItem": false,
    "IsThumbnailFinal": true,
    "IsThumbnailUnapproved": false,
    "ThumbnailUrl": "https://t1.rbxcdn.com/745a4be8c2366db2e55d0a67678434dc",
    "BcOverlayUrl": null,
    "LimitedOverlayUrl": null,
    "DeadlineOverlayUrl": null,
    "LimitedAltText": null,
    "NewOverlayUrl": null,
    "SaleOverlayUrl": null,
    "IosOverlayUrl": null,
    "XboxOverlayUrl": null,
    "GooglePlayOverlayUrl": null,
    "AmazonOverlayUrl": null,
    "IsTransparentBackground": false,
    "IsNewRobuxIconEnabled": true,
    "AssetTypeID": 10,
    "CreatorID": 1,
    "CreatedDate": "/Date(1561635090927)/",
    "UpdatedDate": "/Date(1562003916210)/",
    "IsForSale": false,
    "IsPublicDomain": true,
    "IsLimited": false,
    "IsLimitedUnique": false,
    "MinimumMembershipLevel": 0,
    "OffSaleDeadline": null,
    "ProductId": 586905093
}

API Marketplace

È possibile interrogare gli oggetti avatar dal Marketplace utilizzando il seguente URL: https://catalog.roblox.com/v2/search/items/details?[params]

È possibile sostituire [params] con i parametri di query appropriati per personalizzare la ricerca.

Parametri di query

È possibile specificare i parametri di ricerca aggiungendo una serie di parametri e valori all'URL, ciascuno separato da un &.

Utilizza i seguenti parametri per interrogare Marketplace:

Il seguente URL cercherà i primi 10 elementi "Equipaggiamento" ordinati per tutti i tempi ("OrdineAggregazione") e rilevanza ("OrdineTipo") creati da Roblox ("IdentificativoTargetCreatore"):

https://catalog.roblox.com/v2/search/items/details?Subcategory=5&CreatorTargetId=1&SortType=0&SortAggregation=5&Limit=10

Campi di risposta

Le risposte API vengono riportate in formato JSON. La risposta fornisce i dettali sulla risorsa nella chiave data utilizzando i seguenti campi:

Di seguito è riportato un esempio di risultato atteso 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
        }
    ]
}