지정한 그룹으로 판매할 수 있는 아이템 목록 가져오기

Digital Distribution Hub API

In-Game Store API

개요

API 정의 다운로드

사용자 특성

관리자

개인 맞춤형 카탈로그

번들

관리자

카탈로그

장바구니 및 결제

장바구니(클라이언트 측)

장바구니(서버 측)

결제(클라이언트 측)

결제(서버 측)

주문

무료 아이템

일반

웹훅

선주문

판매자

지정한 그룹으로 판매할 수 있는 아이템 목록 가져오기

get

ID를 사용하여 판매 가능한 아이템 가져오기

get

SKU로 판매할 수 있는 아이템 가져오기

공통 지역

게임 키

카탈로그

권한

관리자

프로모션

일반

가상 아이템 및 인게임 재화

관리자

카탈로그

가상 결제

NFT 아이템

관리자

카탈로그

제한 사항

관리

보상 체인 및 밸류 포인트

관리자

클라이언트

클랜 클라이언트

UPSELL

관리자

클라이언트

CONNECTOR

관리자

Pay Station API

Subscriptions API

Webhooks

지정한 그룹으로 판매할 수 있는 아이템 목록 가져오기Client-side

get/v2/project/{project_id}/items/group/{external_id}

카탈로그 작성을 위해 지정된 그룹에서 판매할 수 있는 아이템 목록을 가져옵니다.

주의

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

참고

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

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer 프로젝트 ID. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다. Example: 59080
external_id required	string Default: "armour" Group external ID.

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 The list of additional fields. These fields will be in the response if you send them in your request. Items Enum: "media_list" "order" "long_description" "custom_attributes"
country	string ISO 3166-1 alpha-2에 따른 두 글자 대문자 국가 코드입니다. Xsolla에서 지원하는 국가 및 국가 판별 프로세스에 대한 자세한 내용은 설명서를 확인하세요. 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

그룹을 찾을 수 없습니다. external_id이 올바르고 그룹이 꺼져 있거나 삭제되지 않았는지 확인해야 합니다.

Request samples

Response samples

application/json

{"has_more": true,
"items": [{"attributes": [ ],
"can_be_bought": true,
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "Electric shield",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png",
"inventory_options": {"consumable": null,
"expiration_period": [{"attributes": [ ],
"can_be_bought": true,
"description": "Royal shield",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259775,
"name": "Royal shield",
"price": {"amount": "19.99",
"amount_without_discount": "19.99",
"currency": "USD"
},
"promotions": [ ],
"sku": "royal_shield",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 40,
"amount_without_discount": 40,
"calculated_price": {"amount": "40.00",
"amount_without_discount": "40.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 400,
"amount_without_discount": 400,
"calculated_price": {"amount": "400.00",
"amount_without_discount": "400.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
},
{"attributes": [ ],
"can_be_bought": true,
"description": "Ancient helmet",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259776,
"name": "Ancient helmet",
"price": {"amount": "1.99",
"amount_without_discount": "1.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "ancient_helmet",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 2,
"amount_without_discount": 2,
"calculated_price": {"amount": "2.00",
"amount_without_discount": "2.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 4,
"amount_without_discount": 4,
"calculated_price": {"amount": "4.00",
"amount_without_discount": "4.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 40,
"amount_without_discount": 40,
"calculated_price": {"amount": "40.00",
"amount_without_discount": "40.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
},
{"attributes": [ ],
"can_be_bought": true,
"description": "Wooden helmet",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259777,
"name": "Wooden helmet",
"price": {"amount": "0.99",
"amount_without_discount": "0.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "wooden_helmet",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 1,
"amount_without_discount": 1,
"calculated_price": {"amount": "1.00",
"amount_without_discount": "1.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 2,
"amount_without_discount": 2,
"calculated_price": {"amount": "2.00",
"amount_without_discount": "2.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
}
]
},
"is_free": false,
"item_id": 259774,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Electric shield",
"price": {"amount": "9.99",
"amount_without_discount": "9.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "electric_shields",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 10,
"amount_without_discount": 10,
"calculated_price": {"amount": "10.00",
"amount_without_discount": "10.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 200,
"amount_without_discount": 200,
"calculated_price": {"amount": "200.00",
"amount_without_discount": "200.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
],
"vp_rewards": [{"amount": 130,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"item_id": 175232,
"name": "Value point",
"sku": "value_point_1"
},
{"amount": 50,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_clan": true,
"item_id": 186321,
"name": "Clan Reward VP 1",
"sku": "clan_value_point_sku_1"
}
]
}
]
}