Lire une liste de lots par groupe spécifique
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" External ID du groupe. |
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 La liste des champs supplémentaires. Ces champs figureront dans la réponse si vous les envoyez dans votre requête. |
| country | string Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2. Affiche les restrictions et les prix régionaux pour un catalogue si ceux-ci ont été spécifiés lors de la création d'un objet. Note
Si vous ne spécifiez pas explicitement le pays, il sera défini en fonction de l'adresse IP de l'utilisateur. 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"
}
]
}
]
}
