Lire une liste de jeux 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: 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. 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 de jeux a été reçue avec succès.

Request samples

Response samples

application/json

{"has_more": false,
"items": [{"attributes": [{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "23fda05111c125608af8f1fa0e99db45a10ea1cc",
"value": "Horror"
}
]
}
],
"description": "Game description",
"groups": [{"external_id": "all",
"name": "All games"
},
{"external_id": "Xsolla",
"name": "Xsolla games"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"name": "Game name",
"promotions": [ ],
"sku": "game_1",
"type": "unit",
"unit_items": [{"can_be_bought": true,
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": true,
"is_free": false,
"is_pre_order": true,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": "2020-08-11T10:00:00+03:00",
"sku": "game_key_01",
"type": "game_key",
"virtual_prices": [ ],
"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"
}
]
},
{"can_be_bought": true,
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_free": false,
"is_pre_order": false,
"periods": [ ],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": null,
"sku": "game_key_02",
"type": "game_key",
"virtual_prices": [ ],
"vp_rewards": [ ]
}
],
"unit_type": "game"
},
{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
}
],
"description": "Game description",
"groups": [{"external_id": "all",
"name": "All games"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"name": "Game name",
"promotions": [ ],
"sku": "game_2",
"type": "unit",
"unit_items": [{"can_be_bought": true,
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_free": false,
"is_pre_order": false,
"periods": [{"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": null,
"sku": "game_key_01",
"type": "game_key",
"virtual_prices": [ ],
"vp_rewards": [ ]
}
],
"unit_type": "game"
}
]
}