クリエイター ストア クエリ

Robloxのアセットをスタジオの外で検索するには、クリエイター ストア API にアクセスします。クリエイター ストア API を使用して、メッシュ、モデル、オーディオなどのスタジオ アセットをクエリし、マーケットプレイス API を使用してマーケットプレイスのアバター アセットをクエリします。

各 API には、特定のカタログ用の URL とカスタム検索パラメータが必要です。URL とパラメータの両方が有効な場合、API は検索結果を JSON 形式で返します。

クリエイター ストア API

検索のためにクリエイター ストア API を呼び出す方法については、Open Cloud reference の Toolbox Service を参照してください。

マーケットプレイス API

以下の URL を使用して、マーケットプレイスからアバター アイテムをクエリできます： `https://catalog.roblox.com/v1/search/items/details?[params]``

適切な クエリパラメーター で [params] を置き換えて、検索をカスタマイズできます。

クエリパラメーター

URL に一連のパラメーターと値を追加することにより、検索パラメーターを指定できます。それぞれは & で区切られています。

マーケットプレイスをクエリするには、次のパラメーターを使用してください：

次の URL は、Roblox（CreatorTargetId および CreatorType）によって作成された、すべての時間にわたる関連性（SortAggregation および SortType）でソートされた「アクセサリー」の「ギア」アイテムの最初の 10 件を検索します。

`https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&CreatorType=User&SortType=0&SortAggregation=5&Limit=10``

応答フィールド

API の応答は JSON 形式で返されます。応答は、次のフィールドを使用して data キーのアセットの詳細を提供します：

以下は、単一アイテムの予想される返却出力の例です：

{
	"keyword": null,
	"previousPageCursor": null,
	"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
	"data": [
    {
        "id":527373900,
        "itemType":
        "Asset",
        "assetType":42,
        "name":"落ち着かない魂のバンダナ",
        "description":"このバンダナはあなたを幽霊に溶け込ませることはできませんが、少なくともスタイリッシュです。",
        "productId":41270974,
        "genres":[
          "Scary",
          "Adventure"
          ],
        "itemStatus":[],
        "itemRestrictions":[],
        "creatorType":"User",
        "creatorTargetId":1,
        "creatorName":"Roblox",
        "price":300,
        "favoriteCount":15943,
        "offSaleDeadline":null
        }
	]
}