Lire la liste des objets virtuels par external ID d'un groupe spécifique

Lire la liste des objets virtuels par external ID d'un groupe spécifiqueServer-sideAdmin

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

Récupère la liste des objets virtuels au sein d'un groupe à des fins d'administration.

Note

N'utilisez pas cet endpoint pour créer un catalogue de magasin.

SecuritybasicAuth

Request

path Parameters

project_id required	integer ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet. Example: 44056
external_id required	string Default: "all" Group external ID.

query Parameters

limit	integer Nombre maximal d'éléments sur une page. Example: limit=50
offset	integer Numéro de l'élément à partir duquel la liste est générée (le décompte commence à 0). Example: offset=0
promo_code	string [ 1 .. 128 ] characters Code unique sensible à la casse. Comprend des lettres et des chiffres. Example: promo_code=WINTER2021

Responses

200

La liste d'objets virtuels a été reçue avec succès.

401

L'authentification de base n'a pas été passée ou est incorrecte. Vérifiez que vous avez utilisé l'authentification de base ou des informations d'identification correctes.

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": [{"external_id": "hair",
"name": {"en": "Hair"
}
},
{"external_id": "accessory",
"name": {"en": "Accessory"
}
}
],
"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": [{"external_id": "hair",
"name": {"en": "Hair"
}
},
{"external_id": "accessory",
"name": {"en": "Accessory"
}
}
],
"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": [{"external_id": "hair",
"name": {"en": "Hair"
}
},
{"external_id": "accessory",
"name": {"en": "Accessory"
}
}
],
"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": [ ]
}
]
}