Lire une clé de jeu pour le catalogue

Note

Cet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites disponibles pour l'utilisateur et les promotions.

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
item_sku required	string Default: "xsollus_basic_edition_steam" UGS de l'objet.

query Parameters

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. Items Enum: "media_list" "order" "long_description" "custom_attributes"
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

Responses

200

La clé de jeu a été reçue avec succès.

404

Clé de jeu non trouvée.

Request samples

Response samples

application/json

{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
},
{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "23fda05111c125608af8f1fa0e99db45a10ea1cc",
"value": "Horror"
}
]
}
],
"can_be_bought": true,
"description": "Game description",
"drm_name": "Steam",
"drm_sku": "steam",
"groups": [{"external_id": "all",
"name": "All games"
},
{"external_id": "Xsolla",
"name": "Xsolla games"
}
],
"has_keys": true,
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"is_free": false,
"is_pre_order": true,
"limits": null,
"name": "Game name",
"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"
},
"promotions": [ ],
"release_date": "2020-08-11T10:00:00+03:00",
"sku": "game_1",
"type": "game_key",
"virtual_prices": [ ]
}