Получение списка виртуальных предметов по указанному External 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" External 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": [ ]
}
]
}