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

카탈로그에 게임 키 가져오기

get/v2/project/{project_id}/items/game/key/sku/{item_sku}

카탈로그에 대한 게임 키를 가져옵니다.

참고

권한 없이 액세스할 수 있는 이 엔드포인트는 일반 데이터를 반환합니다. 그러나 권한이 제공되면 사용 가능한 사용자 제한 및 프로모션과 같은 개인화된 결과를 제공하기 위해 사용자별 세부 정보를 사용하여 응답이 보강됩니다.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

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

Example: 44056
item_sku
required
string
Default: "xsollus_basic_edition_steam"

아이템 SKU입니다.

query Parameters
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

게임 키를 성공적으로 수신했습니다.

404

게임 키를 찾을 수 없습니다.

Request samples
Response samples
application/json
{
  • "attributes": [
    ],
  • "can_be_bought": true,
  • "description": "Game description",
  • "drm_name": "Steam",
  • "drm_sku": "steam",
  • "groups": [
    ],
  • "has_keys": true,
  • "is_free": false,
  • "is_pre_order": true,
  • "limits": null,
  • "name": "Game name",
  • "periods": [
    ],
  • "price": {
    },
  • "promotions": [ ],
  • "release_date": "2020-08-11T10:00:00+03:00",
  • "sku": "game_1",
  • "type": "game_key",
  • "virtual_prices": [ ]
}