Lire une liste de lots par groupe spécifiqueClient-side
Récupère une liste de lots au sein d'un groupe pour la constitution d'un catalogue.
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.
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é.
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 |
| 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. |
| 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 |
La liste de lots a été reçue avec succès.
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
- 200
{- "has_more": true,
- "items": [
- {
- "attributes": {
- "external_id": "genre",
- "name": "Genre",
- "values": [
- {
- "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
- "value": "Casual"
}, - {
- "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
- "value": "Strategy"
}, - {
- "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
- "value": "Mobile"
}
]
}, - "bundle_type": "standard",
- "can_be_bought": true,
- "content": [
- {
- "attributes": {
- "external_id": "size",
- "name": "Size",
- "values": [
- {
- "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
- "value": "Large"
}
]
}, - "description": "Big Rocket - short description.",
- "groups": [ ],
- "is_free": false,
- "limits": {
- "per_user": {
- "available": 3,
- "recurrent_schedule": {
- "interval_type": "weekly",
- "reset_next_date": 1746057600
}, - "total": 5
}
}, - "name": "Big Rocket",
- "price": {
- "amount": 10.99,
- "amount_without_discount": 10.99,
- "currency": "USD"
}, - "quantity": 100,
- "sku": "big_rocket",
- "type": "virtual_currency",
- "virtual_item_type": "non_consumable",
- "virtual_prices": [ ]
}
], - "custom_attributes": {
- "attr": "value",
- "purchased": 0
}, - "description": "pricePoint_44056_1",
- "groups": [ ],
- "image_url": null,
- "is_free": false,
- "item_id": 61031,
- "limits": {
- "per_user": {
- "available": 3,
- "recurrent_schedule": {
- "interval_type": "weekly",
- "reset_next_date": 1746057600
}, - "total": 5
}
}, - "long_description": null,
- "media_list": [ ],
- "name": "kg_10.00_bundle",
- "order": 999,
- "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": 9.99,
- "amount_without_discount": 9.99,
- "currency": "USD"
}, - "promotions": [ ],
- "sku": "kg_1",
- "total_content_price": {
- "amount": 10.99,
- "amount_without_discount": 10.99,
- "currency": "USD"
}, - "type": "bundle",
- "virtual_prices": [ ],
- "vp_rewards": [
- {
- "amount": 130,
- "item_id": 175232,
- "name": "Value point",
- "sku": "value_point_1"
}, - {
- "amount": 50,
- "is_clan": true,
- "item_id": 186321,
- "name": "Clan Reward VP 1",
- "sku": "clan_value_point_sku_1"
}
]
}
]
}
