크리에이터 스토어 쿼리

크리에이터 스토어 API에 액세스하여 스튜디오 외부의 Roblox 자산을 검색할 수 있습니다.크리에이터 스토어 API를 사용하여 메쉬, 모델 및 오디오와 같은 Studio 자산을 쿼리하고 마켓플레이스 API를 사용하여 마켓플레이스에서 아바타 자산을 쿼리합니다.

각 API에는 특정 카탈로그에 대한 URL과 사용자 지정 검색 매개변수가 필요합니다.URL과 매개 변수 모두 유효하면 API는 검색 결과와 함께 JSON 형식을 반환합니다.

크리에이터 스토어 API

검색을 위해 크리에이터 스토어 API에 전화하는 방법에 대한 자세한 내용은 오픈 클라우드 참조에 있는 도구 상자 서비스를 참조하십시오.

마켓플레이스 API

다음 URL을 사용하여 마켓플레이스에서 아바타 아이템을 쿼리할 수 있습니다: https://catalog.roblox.com/v1/search/items/details?[params]

검색을 사용자 지정하기 위해 [params] 를 적절한 쿼리 매개변수 로 교체할 수 있습니다.

쿼리 매개변수

URL에 여러 매개변수와 값을 추가하여 검색 매개변수를 지정할 수 있으며, 각각은 &로 구분됩니다.

다음 매개변수를 사용하여 마켓플레이스 쿼리:

다음 URL은 Roblox("CreatorTargetId")가 생성한 모든 시간("SortAggregation")과 관련성("SortType")에 따라 정렬된 "액세서리"에서 처음 10개의 "장비" 항목을 검색합니다.

https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&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":"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
        }
	]
}