Du kannst die Assets von Roblox außerhalb von Studio suchen, indem du die Creator-Store-API aufrufst.Verwende die Creator-Store-API, um Studio-Assets wie Meshes, Modelle und Audiodateienabzufragen, und die Marktplatz-API, um Avatar-Assets auf dem Marktplatz abzufragen.
Jede API erfordert eine URL und benutzerdefinierte Such参数 für diesen spezifischen Katalog.Wenn sowohl URL als auch Parameter gültig sind, gibt die API ein JSON-Format mit den Ergebnissen Ihrer suchenzurück.
Creator-Store-API
Für Informationen zu Anrufen der Creator-Store-API für die suchensiehe Toolbox-Service im Open Cloud-Referenz.
Marktplatz-API
Du kannst Avatar-Artikel vom Marktplatz abrufen, indem du die folgende URL verwendest: https://catalog.roblox.com/v1/search/items/details?[params]
Du kannst [params] durch die entsprechenden Suchparameter ersetzen, um deine suchenanzupassen.
Abfrage参数
Du kannst Suchparameter spezifizieren, indem du einer URL eine Reihe von Parametern und Werten hinzufügst, die durch ein & getrennt sind.
Verwende die folgenden Parameter, um den Marktplatz abzufragen:
| Parameter | Typ | Optionen und Werte |
|---|---|---|
| Kategorie | byte | 0 = Vorgestellt 1 = Alles 2 = Sammlerstücke 3 = Kleidung 4 = Körperteile 5 = Ausrüstung 11 = Accessoires 12 = Avataranimationen 13 = Community-Kreationen |
| CreatorTyp | byte | 1 = Benutzer 2 = Gruppe |
| Schöpfername | string | Suche nach Namens des Erstellers. Wenn Enum.CreatorType nicht bereitgestellt wird, ist die Suche nur für Benutzer. |
| CreatorZielID | lange | Die Benutzer- oder Gruppen-ID, abhängig vom bereitgestellten CreatorType. |
| Zeiger | string | Jede Suchantwort enthält ein nextPageCursor wenn es eine nächste Seite gibt, und ein previousPageCursor wenn es eine vorherige Seite gibt.Geben Sie einen dieser Werte im Cursor-Parameter Ihrer nächsten Abfrage ein, um die nächste oder vorherige Ergebnisseite zu erhalten.Der Cursor ist gültig, wenn die anderen Suchparameter gleich bleiben. |
| Gattungen | byte | Gibt das Genre für die suchenan.Der empfohlene Ansatz für das Filtern nach Genres besteht darin, die URL einer Katalogseite zu übereinstimmen. = TownAndCity = Mittelalter = SciFi = Kampf = Horror = Navigation = Abenteuer = Sport = Komödie = Militär = Gebäude = FPS = RPG |
| Kennwort | string | suchen. |
| Begrenzung | zahl int | Anzahl der zu zurückgebenErgebnisse. Werte sind derzeit auf 10, 28 und 30 beschränkt. |
| MaxPreis | zahl int | Der maximale Preis in Robux von Artikeln in der Abfrage. |
| Mindestpreis | zahl int | Der minimale Preis in Robux von Artikeln in der Abfrage. |
| Sortierung der Aggregation | byte | 1 = PastDay 3 = PastWeek 4 = PastMonth 5 = AllTime |
| SortierenTyp | byte | 0 = Relevanz (Standard) 1 = Favorisiert 2 = Verkauf 3 = Aktualisiert 4 = PreisAsc 5 = PreisDesc |
| Unterkategorie | byte | Deutsch Dokumentation Dokumentation Beispiel = Dokumentation Dokumentation = Dokumentation = Dokumentation = Dokumentation = Dokumentation = Dokumentation = Dokumentation = Dokumentation |
Die folgende URL sucht die ersten 10 "Ausrüstungs"-Artikel in "Zubehör" nach Zeit ("SortAggregation") und Relevanz ("SortType") durch Roblox ("CreatorTargetId") erstellt:
https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&SortType=0&SortAggregation=5&Limit=10
Antwortfelder
API-Antworten werden in einem JSON-Format zurückgegeben. Die Antwort liefert Asset-Details in der data Schlüssel mit den folgenden Feldern:
| Bereich | Beschreibung |
|---|---|
| AssetTyp | Einer der folgenden Asset-Typ-Werte (wird nur zurückgegeben, wenn der Artikel ein Objektist). = T-Shirt = Hut = Hemd = Hose = Kopf = Gesicht = Ausrüstung = Arme = Beine = Torso = Rechtsarm = Linksarm = Gesichtszubehör = Nacken = Atemanimation = Sprunganimation = Laufanimation = Laufanimation = EmotionAnimation = Emoteanimation |
| Bündeltyp | Die Bündeltyp-ID (wird nur zurückgegeben, wenn das Element ein Bündel ist). Mögliche Werte sind BodyParts und AvatarAnimations . |
| Schöpfername | Der Name des Creator:in. |
| ErstellerZielID | Die ID des Creator:in. |
| Erstellertyp | eingebendes Erstellers des Artikels. |
| beschreibung | Die Beschreibung. |
| Favoritenanzahl | Die Favoritenanzahl eines Artikels. |
| gattungen | Liste der Genres des Artikels.Mögliche Werte umfassen All , Tutorial , Scary , TownAndCity , War , Funny , Fantasy , Adventure , SciFi , Pirate , FPS , RPG , Sports , Ninja , und WildWest. |
| id | Die ID des Artikel. |
| ArtikelRestriktionen | Liste der Einschränkungen des Artikels. Mögliche Werte umfassen ThirteenPlus , LimitedUnique , Limited und Rthro . |
| Artikelstatus | Liste der Statusflaggen des Artikels.Mögliche Werte umfassen New , Sale , XboxExclusive , AmazonExclusive , GooglePlayExclusive , IosExclusive , und SaleTimer . |
| Artikeltyp | Der eingeben. Mögliche Werte sind Asset oder Bundle . |
| niedrigster Preis | Der niedrigste Händlerpreis des Artikels (wird nur zurückgegeben, wenn der Artikel verkaufbar ist). |
| bezeichnung | Der Name des Artikels. |
| preis | Der Verkaufspreis des Artikels (der aktuelle Preis kann abweichen, wenn der Artikel wiederverkäuflich ist). |
| preisStatus | Der Preisstatus eines Artikels, der nicht zum Verkauf steht. Mögliche Werte sind Free , OffSale oder NoResellers . |
| kaufCount | Die Anzahl der Käufe eines Artikels. |
| Verfügbare Einheiten für den Verbrauch | Die Einheit, die für den Verzehr eines begrenzten einzigartigen Artikels zur Verfügung steht. |
Das Folgende ist ein Beispiel für erwartete Rückgabeausgabe für ein einzelnes Artikel:
{
"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
}
]
}