지정한 그룹으로 게임 키 목록 가져오기

Attention

All projects have the limitation to the number of items that you can get in the response. The default and maximum value is 50 items per response. To get more data page by page, use limit and offset fields.

Note

The use of the item catalog API calls is available without authorization, but to get a personalized catalog, you must pass the user JWT in the Authorization header.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer 프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다. Example: 44056
external_id required	string Default: "all" 그룹 외부 ID입니다.

query Parameters

limit	integer >= 1 페이지 요소 개수 제한입니다. Example: limit=50
offset	integer >= 0 목록이 생성된 요소의 개수입니다(개수는 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" "item_order_in_group"
country	string ISO 3166-1 alpha-2에 따른 2자리 대문자 국가 코드입니다. 엑솔라에서 지원하는 국가 및 국가 판별 프로세스에 대한 자세한 정보는 설명서를 확인하십시오. 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": [{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
},
{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "23fda05111c125608af8f1fa0e99db45a10ea1cc",
"value": "Horror"
}
]
}
],
"description": "Game description",
"drm_name": "Steam",
"drm_sku": "steam_key_1",
"groups": [{"external_id": "all",
"item_order_in_group": 2,
"name": "All games"
},
{"external_id": "Xsolla",
"item_order_in_group": 1,
"name": "Xsolla games"
}
],
"has_keys": true,
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"is_free": false,
"is_pre_order": true,
"name": "Game name",
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": "2020-08-11T10:00:00+03:00",
"sku": "com.xsolla.game_1",
"type": "game_key",
"virtual_prices": [ ]
},
{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
},
{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "23fda05111c125608af8f1fa0e99db45a10ea1cc",
"value": "Horror"
}
]
}
],
"description": "Game description",
"drm_name": "Steam",
"drm_sku": "steam_key_2",
"groups": [{"external_id": "all",
"item_order_in_group": 1,
"name": "All games"
}
],
"has_keys": true,
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"is_free": false,
"is_pre_order": false,
"name": "Game name",
"periods": [ ],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": null,
"sku": "com.xsolla.game_2",
"type": "game_key",
"virtual_prices": [ ]
}
]
}