Sie können Robloxs Assets außerhalb von Studio durchsuchen, indem Sie auf die Creator Store API zugreifen. Verwenden Sie die Creator Store API, um Studio-Assets wie Meshes, Modelle und Audios abzufragen, und die Marketplace API, um Avatar-Assets im Marketplace abzufragen.
Jede API erfordert eine URL und benutzerdefinierte Suchparameter für das spezifische Katalog. Wenn sowohl die URL als auch die Parameter gültig sind, gibt die API ein JSON-Format mit den Ergebnissen Ihrer Suche zurück.
Creator Store API
Für Informationen zum Abrufen von Anfragen an die Creator Store API für die Suche siehe Toolbox Service in der Open Cloud-Dokumentation.
Marketplace API
Sie können Avatar-Artikel aus dem Marketplace mit der folgenden URL abfragen: https://catalog.roblox.com/v1/search/items/details?[params]
Sie können [params] durch die entsprechenden Abfrageparameter ersetzen, um Ihre Suche anzupassen.
Abfrageparameter
Sie können Suchparameter angeben, indem Sie eine Reihe von Parametern und Werten an die URL anhängen, die jeweils durch ein & getrennt sind.
Verwenden Sie die folgenden Parameter, um den Marketplace abzufragen:
| Parameter | Typ | Optionen und Werte |
|---|---|---|
| Kategorie | byte | 0 = Ausgewählt 1 = Alle 2 = Sammlerstücke 3 = Kleidung 4 = Körperteile 5 = Ausrüstung 11 = Zubehör 12 = Avatar-Animationen 13 = Community-Kreationen |
| CreatorType | byte | 1 = Benutzer 2 = Gruppe Abfragen, die CreatorType verwenden, erfordern auch den Parameter CreatorTargetId. |
| CreatorTargetId | long | Die Benutzer- oder Gruppen-ID, abhängig vom bereitgestellten CreatorType. Abfragen, die CreatorTargetId verwenden, erfordern auch den Parameter CreatorType. |
| CreatorName | string | Nach dem Erstellernamen suchen. Wenn Enum.CreatorType nicht angegeben ist, wird nur nach Benutzern gesucht. |
| Cursor | string | Jede Suchantwort enthält einen nextPageCursor, wenn es eine nächste Seite gibt, und previousPageCursor, wenn es eine vorherige Seite gibt. Übergeben Sie einen dieser Werte im Cursor-Parameter Ihrer nächsten Abfrage, um die nächste oder vorherige Seite der Ergebnisse zu erhalten. Der Cursor ist gültig, wenn die anderen Abfrageparameter gleich bleiben. |
| Genres | byte | Gibt das Genre für die Suche an. Der empfohlene Ansatz zum Filtern nach Genres besteht darin, die URL einer Katalogseite abzugleichen. 1 = Stadt und Land 2 = Mittelalter 3 = SciFi 4 = Kampf 5 = Horror 6 = Marine 7 = Abenteuer 8 = Sport 9 = Komödie 10 = Western 11 = Militär 13 = Bau 14 = FPS 15 = RPG |
| Stichwort | string | Standard Stichwortsuche. |
| Limit | int | Anzahl der zurückzugebenden Ergebnisse. Die Werte sind derzeit auf 10, 28 und 30 beschränkt. |
| MaxPrice | int | Der maximale Preis in Robux für die Artikel in der Abfrage. |
| MinPrice | int | Der minimale Preis in Robux für die Artikel in der Abfrage. |
| SortAggregation | byte | 1 = Letzter Tag 3 = Letzte Woche 4 = Letzter Monat 5 = Alle Zeiten |
| SortType | byte | 0 = Relevanz (Standard) 1 = Favorisiert 2 = Verkäufe 3 = Aktualisiert 4 = PreisAufsteigend 5 = PreisAbsteigend |
| Subkategorie | byte | 0 = Ausgewählt 1 = Alle 2 = Sammlerstücke 3 = Kleidung 4 = Körperteile 5 = Ausrüstung 9 = Hüte 10 = Gesichter 12 = Hemden 13 = T-Shirts 14 = Hosen 15 = Köpfe 19 = Zubehör 20 = Haarzubehör 21 = Gesichtszubehör 22 = Halszubehör 23 = Schulterzubehör 24 = Vorderzubehör 25 = Rückenzubehör 26 = Taille-Zubehör 27 = Avatar-Animationen 37 = Bundles 38 = Animations-Bundles 39 = Emote-Animationen 40 = Community-Kreationen 41 = Nahkampf 42 = Fernkampf 43 = Explosiv 44 = Power-Up 45 = Navigation 46 = Musikalisch 47 = Sozial 48 = Bau 49 = Transport 54 = Kopf-Zubehör 55 = Klassische T-Shirts 56 = Klassische Hemden 57 = Klassische Hosen 58 = T-Shirt-Zubehör 59 = Hemd-Zubehör 60 = Hosen-Zubehör 61 = Jacken-Zubehör 62 = Pullover-Zubehör 63 = Shorts-Zubehör 64 = Schuh-Bundles 65 = Kleid-Rock-Zubehör 66 = Dynamische Köpfe |
Die folgende URL sucht nach den ersten 10 "Ausrüstungs"-Artikeln in "Zubehör", sortiert nach aller Zeiten ("SortAggregation") und Relevanz ("SortType"), erstellt von Roblox ("CreatorTargetId" und "CreatorType"):
https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&CreatorType=User&SortType=0&SortAggregation=5&Limit=10
Antwortfelder
API-Antworten werden im JSON-Format zurückgegeben. Die Antwort bietet Details zu den Assets im data-Schlüssel mit den folgenden Feldern:
| Feld | Beschreibung |
|---|---|
| assetType | Einer der folgenden Werte für den Assettyp (wird nur zurückgegeben, wenn der Artikel ein Asset ist). 2 = T-Shirt 8 = Hut 11 = Shirt 12 = Hose 17 = Kopf 18 = Gesicht 19 = Ausrüstung 25 = Arme 26 = Beine 27 = Oberkörper 28 = rechter Arm 29 = linker Arm 30 = linkes Bein 31 = rechtes Bein 41 = Haarzubehör 42 = Gesichtszubehör 43 = Halszubehör 44 = Schulterzubehör 45 = Vorderzubehör 46 = Rückenzubehör 47 = Taille-Zubehör 48 = Kletteranimation 49 = Todesanimation 50 = Fallanimation 51 = Idle-Animation 52 = Sprunganimation 53 = Laufanimation 54 = Schwimmanimation 55 = Geh-Animation 56 = Pose-Animation 61 = Emote-Animation |
| bundleType | Die Bundle-type-ID (wird nur zurückgegeben, wenn der Artikel ein Bundle ist). Mögliche Werte sind BodyParts und AvatarAnimations. |
| creatorName | Der Name des Erstellers. |
| creatorTargetId | Die ID des Erstellers. |
| creatorType | Der Erstellertyp des Artikels. |
| description | Die Artikelbeschreibung. |
| favoriteCount | Die Anzahl der Favoriten eines Artikels. |
| genres | Liste der Genres des Artikels. Mögliche Werte sind Alle, Tutorial, Gruselig, Stadt und Land, Krieg, Lustig, Fantasy, Abenteuer, SciFi, Pirate, FPS, RPG, Sport, Ninja und Wilder Westen. |
| id | Die ID des Artikels. |
| itemRestrictions | Liste der Beschränkungen des Artikels. Mögliche Werte sind DreizehnPlus, LimitedUnique, Begrenzt und Rthro. |
| itemStatus | Liste der Statusflags des Artikels. Mögliche Werte sind Neu, Verkauf, XboxExklusiv, AmazonExklusiv, GooglePlayExklusiv, IosExklusiv und VerkaufTimer. |
| itemType | Der Artikeltyp. Mögliche Werte sind Asset oder Bundle. |
| lowestPrice | Der niedrigste Wiederverkaufspreis des Artikels (wird nur zurückgegeben, wenn der Artikel wiederverkaufbar ist). |
| name | Der Artikelname. |
| price | Der Preis des Artikels (der aktuelle Preis kann abweichen, wenn der Artikel wiederverkaufbar ist). |
| priceStatus | Der Preisstatus eines Artikels, der nicht im Angebot ist. Mögliche Werte sind Kostenlos, NichtVerkauf oder KeineWiederverkäufer. |
| purchaseCount | Die Anzahl der Käufe eines Artikels. |
| unitsAvailableForConsumption | Die Einheit, die für den Verzehr eines limitierten einzigartigen Artikels verfügbar ist. |
Die folgende ist ein Beispiel für eine erwartete Rückgabeausgabe für einen einzelnen Artikel:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Unruhige Seelen Bandana",
"description":"Dieses Bandana hilft Ihnen nicht, sich mit Geistern zu vermischen, aber zumindest sind Sie stilvoll.",
"productId":41270974,
"genres":[
"Gruselig",
"Abenteuer"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"Benutzer",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}