管理用の仮想アイテムリストを取得

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

管理用のプロジェクト内の仮想アイテムリストを取得します。

注

このエンドポイントは、ストアカタログの構築に使用しないでください。

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

Example: 44056

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": [{"external_id": "attr_1",
"name": {"en-US": "OK"
},
"values": [{"external_id": "val1",
"value": {"en-US": "VALUE"
}
},
{"external_id": "val2",
"value": {"en-US": "VALUE2"
}
}
]
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": {"en": "Suit up with flair showcasing your allegiance to Xsolla"
},
"groups": [{"children": [ ],
"description": {"en": "featured"
},
"external_id": "featured",
"id": 11,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "featured"
},
"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": "Premium"
},
"external_id": "Premium",
"id": 107,
"image_url": null,
"is_enabled": true,
"level": 0,
"name": {"en": "Premium"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "Non-consumable items"
},
"external_id": "NonConsumableGroupCode",
"id": 113,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Non-consumable"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"inventory_options": {"consumable": false,
"expiration_period": null
},
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": null,
"per_user": null,
"recurrent_schedule": null
},
"long_description": {"en": "The metal coverings formerly worn by soldiers or warriors to protect the body in battle."
},
"media_list": [ ],
"name": {"en": "Maximum Armor Xsolla  Skin"
},
"order": 1,
"periods": [ ],
"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_1",
"type": "virtual_good",
"vc_prices": [ ]
},
{"attributes": [ ],
"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": 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_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": [ ]
}
]
}