Xsolla-logo
  • 문서화
  • 계정 생성

가상 아이템 목록 가져오기

get/v2/project/{project_id}/items/virtual_items

카탈로그 작성을 위해 가상 아이템 목록을 가져옵니다.

주의

모든 프로젝트에는 응답에서 얻을 수 있는 아이템 수에 제한이 있습니다. 기본값과 최대값은 응답당 50개 아이템입니다. 페이지별로 더 많은 데이터 페이지를 가져오려면 제한오프셋 필드를 사용합니다.

참고

일반적으로 아이템 카탈로그는 권한이 없어도 사용할 수 있습니다.
권한이 있는 사용자만 사용자 맞춤형 카탈로그를 가져올 수 있습니다.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

프로젝트 ID. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

Example: 44056
query Parameters
limit
integer

페이지 요소 개수 제한입니다.

Example: limit=50
offset
integer

목록이 생성된 요소의 개수입니다(개수는 0부터 시작함).

Example: offset=0
locale
string
Default: "en"

응답 언어입니다. ISO 639-1에 따른 두 자리 소문자 언어 코드입니다.

additional_fields[]
Array of strings

추가 필드의 목록입니다. 이러한 필드는 요청에서 보내는 경우 응답에 포함됩니다.

Items Enum: "media_list" "order" "long_description" "custom_attributes"
country
string

ISO 3166-1 alpha-2에 따른 두 자리 대문자 국가 코드입니다. 아이템을 생성하는 동안 지역 가격 및 제한 사항을 지정한 경우 카탈로그에 대한 해당 정보를 표시합니다.

참고

국가를 명시적으로 지정하지 않으면 사용자의 IP 주소를 기반으로 국가가 설정됩니다.

Example: country=US
promo_code
string [ 1 .. 128 ] characters

고유한 대/소문자 구분 코드입니다. 문자와 숫자로 이루어져 있습니다.

Example: promo_code=WINTER2021
show_inactive_time_limited_items
integer
Default: 0

사용자가 사용할 수 없는 사용기간 제한 아이템을 표시합니다. 해당 아이템의 사용기간이 아직 시작되지 않았거나 이미 만료되었습니다.

Example: show_inactive_time_limited_items=1
Responses
200

가상 아이템 목록을 성공적으로 수신했습니다.

Request samples
Response samples
application/json
{
  • "has_more": true,
  • "items": [
    ]
}