지정한 그룹 외부 ID로 가상 아이템 목록 가져오기

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

관리를 위해 그룹 내부의 가상 아이템 목록을 가져옵니다.

참고

스토어 카탈로그를 빌드하기 위해 이 엔드포인트를 사용해선 안 됩니다.

SecuritybasicAuth

Request

path Parameters

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

query Parameters

limit	integer 페이지 요소 개수 제한입니다. Example: limit=50
offset	integer 목록이 생성된 요소의 개수입니다(개수는 0부터 시작함). Example: offset=0
promo_code	string [ 1 .. 128 ] characters 고유한 대/소문자 구분 코드입니다. 문자와 숫자로 이루어져 있습니다. Example: promo_code=WINTER2021

Responses

200

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

401

기본 인증이 전달되지 않았거나 잘못되었습니다. 기본 인증 또는 올바른 자격 증명을 사용했는지 확인해야 합니다.

Request samples

Response samples

application/json

{"items": [{"attributes": [ ],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": {"en": "Defend your Empire against Xsolla with the max armor"
},
"groups": [{"children": [ ],
"description": {"en": "Equipment"
},
"external_id": "all",
"id": 10,
"image_url": null,
"is_enabled": true,
"level": 0,
"name": {"en": "Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "equipment"
},
"external_id": "equipment",
"id": 14,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Nice Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "1"
},
"external_id": "Empire",
"id": 17,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Empire"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/67d647ad4f4e9a905bd552b0408db8a8.png",
"inventory_options": {"consumable": true,
"expiration_period": null
},
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": null,
"per_user": {"total": 5
},
"recurrent_schedule": {"per_user": {"day_of_month": 28,
"day_of_week": null,
"displayable_reset_next_date": "2023-03-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "monthly",
"reset_next_date": 1679972400,
"time": "11:00:00+08:00"
}
}
},
"long_description": "merchant_virtual_items_virtual_item_long_description_160310",
"media_list": [ ],
"name": {"en": "Empire Maximum Armor"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 12.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 20.99,
"country_iso": "CZ",
"currency": "CZK",
"is_default": false,
"is_enabled": true
}
],
"regions": [ ],
"sku": "armor_max_2",
"type": "virtual_good",
"vc_prices": [ ]
},
{"attributes": [ ],
"description": {"en": "Moderately protect yourself against the Empires barrage of attacks"
},
"groups": [{"children": [ ],
"description": {"en": "Equipment"
},
"external_id": "all",
"id": 10,
"image_url": null,
"is_enabled": true,
"level": 0,
"name": {"en": "Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "Xsolla"
},
"external_id": "Xsolla",
"id": 12,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Xsolla"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "equipment"
},
"external_id": "equipment",
"id": 14,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Nice Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/7f6e216f8fcc3c1796162897c2b0db01.png",
"inventory_options": {"consumable": true,
"expiration_period": null
},
"is_enabled": true,
"is_free": false,
"is_show_in_store": false,
"limits": {"per_item": null,
"per_user": {"total": 5
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"long_description": {"en": "Armor is a security-as-a-service company that provides cloud security and compliance solutions for small businesses and enterprises."
},
"media_list": [ ],
"name": {"en": "Xsolla Medium Armor"
},
"order": 1,
"periods": [{"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 4.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 20.99,
"country_iso": "CZ",
"currency": "CZK",
"is_default": false,
"is_enabled": true
}
],
"regions": [ ],
"sku": "armor_med_1",
"type": "virtual_good",
"vc_prices": [ ]
},
{"attributes": [{"external_id": "attr_1",
"name": {"en-US": "OK"
},
"values": [{"external_id": "val1",
"value": {"en-US": "VALUE"
}
},
{"external_id": "val2",
"value": {"en-US": "VALUE2"
}
}
]
}
],
"description": {"en": "Moderately protect yourself against Xsolla's barrage of attacks"
},
"groups": [{"children": [ ],
"description": {"en": "Equipment"
},
"external_id": "all",
"id": 10,
"image_url": null,
"is_enabled": true,
"level": 0,
"name": {"en": "Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "equipment"
},
"external_id": "equipment",
"id": 14,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Nice Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "1"
},
"external_id": "Empire",
"id": 17,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Empire"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png",
"inventory_options": {"consumable": true,
"expiration_period": null
},
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": {"available": 455,
"reserved": 5,
"sold": 40,
"total": 500
},
"per_user": {"total": 5
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"long_description": "merchant_virtual_items_virtual_item_long_description_160311",
"media_list": [ ],
"name": {"en": "Empire Medium Armor"
},
"order": 1,
"periods": [ ],
"prices": [{"amount": 4.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 20.99,
"currency": "CZK",
"is_default": false,
"is_enabled": true
}
],
"regions": [ ],
"sku": "armor_med_2",
"type": "virtual_good",
"vc_prices": [ ]
}
]
}