Liste der virtuellen Gegenstände zur Verwaltung abrufen

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

Ruft die Liste der virtuellen Gegenstände innerhalb eines Projekts zur Verwaltung ab.

Hinweis

Verwenden Sie diesen Endpunkt nicht zum Erstellen eines Shop-Katalogs.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Example: 44056

query Parameters

limit	integer Begrenzung der Elementanzahl auf der Seite. Example: limit=50
offset	integer Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0). Example: offset=0
promo_code	string [ 1 .. 128 ] characters Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern. Example: promo_code=WINTER2021

Responses

200

Die Liste der virtuelle Gegenstände wurde erfolgreich empfangen.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

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": [{"external_id": "featured",
"name": {"en": "featured"
}
},
{"external_id": "Xsolla",
"name": {"en": "Xsolla"
}
},
{"external_id": "Premium",
"name": {"en": "Premium"
}
},
{"external_id": "NonConsumableGroupCode",
"name": {"en": "Non-consumable"
}
}
],
"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": [ ]
}
]
}