Lire une liste d'objets vendables par groupe spécifique

Attention

Tous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset.

Note

En général, le catalogue des objets peut être utilisé sans autorisation.
Seuls les utilisateurs autorisés peuvent récupérer un catalogue personnalisé.

SecurityXsollaLoginUserJWT

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: 59080
external_id required	string Default: "armour" 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
locale	string Default: "en" Langue de la réponse. Code de langue à deux lettres minuscules selon la norme ISO 639-1.
additional_fields[]	Array of strings The list of additional fields. These fields will be in the response if you send them in your request. Items Enum: "media_list" "order" "long_description" "custom_attributes"
country	string Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2. Consultez la documentation pour obtenir des informations détaillées sur les pays pris en charge par Xsolla et le processus de détermination du pays. Example: country=US
promo_code	string [ 1 .. 128 ] characters Code unique sensible à la casse. Comprend des lettres et des chiffres. Example: promo_code=WINTER2021
show_inactive_time_limited_items	integer Default: 0 Affiche les objets à durée limitée qui ne sont pas disponibles pour l'utilisateur. La période de validité de ces objets n'ayant pas commencé ou ayant déjà expiré. Example: show_inactive_time_limited_items=1

Responses

200

La liste des objets vendables du groupe spécifié a été reçue avec succès.

404

Groupe non trouvé. Assurez-vous que le paramètre external_id est correct et que le groupe n'est pas désactivé ou supprimé.

Request samples

Response samples

application/json

{"has_more": true,
"items": [{"attributes": [ ],
"can_be_bought": true,
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "Electric shield",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png",
"inventory_options": {"consumable": null,
"expiration_period": [{"attributes": [ ],
"can_be_bought": true,
"description": "Royal shield",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259775,
"name": "Royal shield",
"price": {"amount": "19.99",
"amount_without_discount": "19.99",
"currency": "USD"
},
"promotions": [ ],
"sku": "royal_shield",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 40,
"amount_without_discount": 40,
"calculated_price": {"amount": "40.00",
"amount_without_discount": "40.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 400,
"amount_without_discount": 400,
"calculated_price": {"amount": "400.00",
"amount_without_discount": "400.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
},
{"attributes": [ ],
"can_be_bought": true,
"description": "Ancient helmet",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259776,
"name": "Ancient helmet",
"price": {"amount": "1.99",
"amount_without_discount": "1.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "ancient_helmet",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 2,
"amount_without_discount": 2,
"calculated_price": {"amount": "2.00",
"amount_without_discount": "2.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 4,
"amount_without_discount": 4,
"calculated_price": {"amount": "4.00",
"amount_without_discount": "4.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 40,
"amount_without_discount": 40,
"calculated_price": {"amount": "40.00",
"amount_without_discount": "40.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
},
{"attributes": [ ],
"can_be_bought": true,
"description": "Wooden helmet",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259777,
"name": "Wooden helmet",
"price": {"amount": "0.99",
"amount_without_discount": "0.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "wooden_helmet",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 1,
"amount_without_discount": 1,
"calculated_price": {"amount": "1.00",
"amount_without_discount": "1.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 2,
"amount_without_discount": 2,
"calculated_price": {"amount": "2.00",
"amount_without_discount": "2.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
]
}
]
},
"is_free": false,
"item_id": 259774,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Electric shield",
"price": {"amount": "9.99",
"amount_without_discount": "9.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "electric_shields",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 10,
"amount_without_discount": 10,
"calculated_price": {"amount": "10.00",
"amount_without_discount": "10.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "gold",
"type": "virtual_currency"
},
{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "silver",
"type": "virtual_currency"
},
{"amount": 200,
"amount_without_discount": 200,
"calculated_price": {"amount": "200.00",
"amount_without_discount": "200.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "bronze",
"type": "virtual_currency"
}
],
"vp_rewards": [{"amount": 130,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"item_id": 175232,
"name": "Value point",
"sku": "value_point_1"
},
{"amount": 50,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_clan": true,
"item_id": 186321,
"name": "Clan Reward VP 1",
"sku": "clan_value_point_sku_1"
}
]
}
]
}