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에 일련의 매개변수와 값을 &로 구분하여 추가하여 검색 매개변수를 지정할 수 있습니다.
마켓플레이스를 쿼리하기 위해 다음 매개변수를 사용하세요:
| 매개변수 | 유형 | 옵션 및 값 |
|---|---|---|
| 카테고리 | byte | 0 = 추천 1 = 모두 2 = 수집품 3 = 의류 4 = 신체 부위 5 = 장비 11 = 액세서리 12 = 아바타 애니메이션 13 = 커뮤니티 제작물 |
| 생성자 유형 | byte | 1 = 사용자 2 = 그룹 CreatorType를 사용하는 쿼리에는 CreatorTargetId 매개변수도 필요합니다. |
| 생성자 대상 ID | long | 제공된 생성자 유형에 따라 사용자 또는 그룹 ID. CreatorTargetId를 사용하는 쿼리에는 CreatorType 매개변수도 필요합니다. |
| 생성자 이름 | string | 제작자 이름으로 검색합니다. Enum.CreatorType이 제공되지 않으면 사용자로만 검색됩니다. |
| 커서 | string | 각 검색 응답에는 다음 페이지가 있는 경우 nextPageCursor가 포함되고 이전 페이지가 있는 경우 previousPageCursor가 포함됩니다. 다음 쿼리의 커서 매개변수에 이러한 값 중 하나를 전달하여 결과의 다음 페이지 또는 이전 페이지를 가져옵니다. 커서는 다른 쿼리 매개변수가 동일하게 유지되면 유효합니다. |
| 장르 | byte | 검색을 위한 장르를 지정합니다. 장르 필터링의 권장 방법은 카탈로그 페이지의 URL과 일치시키는 것입니다. 1 = 도시 2 = 중세 3 = 과학 소설 4 = 전투 5 = 공포 6 = 해군 7 = 모험 8 = 스포츠 9 = 코미디 10 = 서부 11 = 군사 13 = 건축 14 = FPS 15 = RPG |
| 키워드 | string | 표준 키워드 검색. |
| 제한 | int | 반환할 결과의 수. 값은 현재 10, 28, 30으로 제한됩니다. |
| 최대 가격 | int | 쿼리에서 항목의 최대 가격 (로벅스). |
| 최소 가격 | int | 쿼리에서 항목의 최소 가격 (로벅스). |
| 정렬 집계 | byte | 1 = 지난 하루 3 = 지난 주 4 = 지난 달 5 = 전체 시간 |
| 정렬 유형 | byte | 0 = 연관성 (기본값) 1 = 찜한 2 = 판매 3 = 업데이트 4 = 가격 오름차순 5 = 가격 내림차순 |
| 하위 카테고리 | byte | 0 = 추천 1 = 모두 2 = 수집품 3 = 의류 4 = 신체 부위 5 = 장비 9 = 모자 10 = 얼굴 12 = 셔츠 13 = 티셔츠 14 = 바지 15 = 머리 19 = 액세서리 20 = 헤어 액세서리 21 = 얼굴 액세서리 22 = 목 액세서리 23 = 어깨 액세서리 24 = 앞 액세서리 25 = 뒤 액세서리 26 = 허리 액세서리 27 = 아바타 애니메이션 37 = 번들 38 = 애니메이션 번들 39 = 이모트 애니메이션 40 = 커뮤니티 제작물 41 = 근접 전투 42 = 원거리 43 = 폭발 44 = 파워업 45 = 내비게이션 46 = 음악 47 = 소셜 48 = 건축 49 = 교통 54 = 머리 액세서리 55 = 클래식 티셔츠 56 = 클래식 셔츠 57 = 클래식 바지 58 = 티셔츠 액세서리 59 = 셔츠 액세서리 60 = 바지 액세서리 61 = 재킷 액세서리 62 = 스웨터 액세서리 63 = 반바지 액세서리 64 = 신발 번들 65 = 드레스/스커트 액세서리 66 = 다이내믹 헤드 |
다음 URL은 Roblox가 만든 모든 시간 기준으로 정렬된("SortAggregation") "액세서리" 내의 처음 10개의 "장비" 항목을 검색합니다("CreatorTargetId" 및 "CreatorType"):
응답 필드
API 응답은 JSON 형식으로 반환됩니다. 응답은 다음 필드에서 data 키를 사용하여 자산 세부정보를 제공합니다:
| 필드 | 설명 |
|---|---|
| 자산 유형 | 다음 자산 유형 값 중 하나 (항목이 자산인 경우에만 반환됨). 2 = 티셔츠 8 = 모자 11 = 셔츠 12 = 바지 17 = 머리 18 = 얼굴 19 = 장비 25 = 팔 26 = 다리 27 = 몸통 28 = 오른쪽 팔 29 = 왼쪽 팔 30 = 왼쪽 다리 31 = 오른쪽 다리 41 = 헤어 액세서리 42 = 얼굴 액세서리 43 = 목 액세서리 44 = 어깨 액세서리 45 = 앞 액세서리 46 = 뒤 액세서리 47 = 허리 액세서리 48 = 클라이밍 애니메이션 49 = 죽음 애니메이션 50 = 낙하 애니메이션 51 = 대기 애니메이션 52 = 점프 애니메이션 53 = 달리기 애니메이션 54 = 수영 애니메이션 55 = 걷기 애니메이션 56 = 포즈 애니메이션 61 = 이모트 애니메이션 |
| 번들 유형 | 번들 유형 ID (항목이 번들인 경우에만 반환됨). 가능한 값은 BodyParts 및 AvatarAnimations입니다. |
| 제작자 이름 | 제작자의 이름. |
| 제작자 대상 ID | 제작자의 ID. |
| 제작자 유형 | 항목의 제작자 유형. |
| 설명 | 항목 설명. |
| 찜한 수 | 항목의 찜 수. |
| 장르 | 항목의 장르 목록. 가능한 값에는 모두, 튜토리얼, 무서운, 도시, 전쟁, 재미, 판타지, 모험, 과학 소설, 해적, FPS, RPG, 스포츠, 닌자, 및 서부가 포함됩니다. |
| ID | 항목의 ID. |
| 항목 제한 | 항목의 제한 목록. 가능한 값에는 열세 이상, 한정 고유, 한정, 및 Rthro가 포함됩니다. |
| 항목 상태 | 항목의 상태 플래그 목록. 가능한 값에는 새 항목, 판매 중, Xbox 독점, 아마존 독점, 구글 플레이 독점, iOS 독점, 및 판매 타이머가 포함됩니다. |
| 항목 유형 | 항목 유형. 가능한 값은 자산 또는 번들입니다. |
| 최저 가격 | 항목의 최저 재판매 가격 (항목이 재판매 가능할 경우에만 반환됨). |
| 이름 | 항목 이름. |
| 가격 | 항목의 목록 가격 (항목이 재판매 가능할 경우 현재 가격은 다를 수 있음). |
| 가격 상태 | 판매 중이지 않은 항목의 가격 상태. 가능한 값에는 무료, 판매 중지, 또는 재판매 불가가 포함됩니다. |
| 구매 횟수 | 항목의 구매 횟수. |
| 소비 가능한 단위 | 한정 고유 항목의 소비 가능한 단위. |
다음은 단일 항목에 대해 예상되는 반환 출력의 예입니다:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"불안한 영혼의 반다나",
"description":"이 반다나는 유령과 섞일 수 있도록 도와주지는 않지만, 적어도 스타일리시하게 보일 수 있습니다.",
"productId":41270974,
"genres":[
"무서운",
"모험"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"User",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}