> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # GET (/users/xuid({xuid})/achievements) > GET (/users/xuid({xuid})/achievements) # GET (/users/xuid({xuid})/achievements) Obtient la liste des succès définis pour le titre, ceux déverrouillés par l'utilisateur ou ceux que l'utilisateur a en cours. Le domaine de ces URI est `achievements.xboxlive.com`. * [Paramètres d'URI](#ID4EX) * [Paramètres de chaîne de requête](#ID4ECB) * [Autorisation](#ID4ENF) * [En-têtes de requête obligatoires](#ID4ESG) * [En-têtes de requête facultatifs](#ID4ESH) * [Corps de la requête](#ID4EIBAC) * [Corps de la réponse](#ID4ETBAC) ## Paramètres d'URI | Paramètre | Type | Description | | - | - | - | | xuid | entier non signé de 64 bits | Identifiant d'utilisateur XBOX (XUID) de l'utilisateur dont la (ressource) est consultée. Doit correspondre au XUID de l'utilisateur authentifié. | ## Paramètres de chaîne de requête \| Paramètre| Obligatoire| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | \| skipItems| Non| entier signé de 32 bits| Retourne les éléments à partir de ceux qui suivent le nombre d'éléments donné. Par exemple, skipItems="3" récupère les éléments à partir du quatrième élément récupéré. | \| continuationToken| Non| chaîne| Retourne les éléments à partir du jeton de continuation donné. | \| maxItems| Non| entier signé de 32 bits| Nombre maximal d'éléments à retourner de la collection, qui peut être combiné avec skipItems et continuationToken pour retourner une plage d'éléments. Le service peut fournir une valeur par défaut si maxItems n'est pas présent, et peut retourner moins de maxItems, même si la dernière page de résultats n'a pas encore été retournée. | \| titleId| Non| chaîne| Un filtre pour les résultats retournés. Accepte un ou plusieurs identifiants de titre décimaux séparés par des virgules.| \| unlockedOnly| Non| Valeur booléenne| Filtre pour les résultats retournés. Si la valeur est true, seuls les succès déverrouillés pour l'utilisateur sont retournés. La valeur par défaut est false.| \| possibleOnly| Non| Valeur booléenne| Filtre pour les résultats retournés. Si la valeur est true, tous les résultats possibles sont retournés, mais pas les métadonnées de déverrouillage, seulement les informations sur les succès provenant de XMS. La valeur par défaut est false.| \| types| Non| chaîne| Un filtre pour les résultats retournés. Peut être "Persistent" ou "Challenge". La valeur par défaut correspond à tous les types pris en charge.| \| orderBy| Non| chaîne| Spécifie l'ordre dans lequel retourner les résultats. Peut être "Unordered", "Title", "UnlockTime" ou "EndingSoon". La valeur par défaut est "Unordered".| ## Autorisation \| Revendication| Obligatoire?| Description| Comportement si absent| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| Utilisateur| L'appelant est un utilisateur XBOX LIVE autorisé.| L'appelant doit être un utilisateur valide sur XBOX LIVE.| 403 Interdit| ## En-têtes de requête obligatoires \| En-tête| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| Authorization| chaîne| Informations d'identification pour l'authentification HTTP. Exemple de valeur : "XBL3.0 x=\;\".| ## En-têtes de requête facultatifs \| En-tête| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| X-RequestedServiceVersion| chaîne| Nom ou numéro de build du service XBOX LIVE auquel cette requête doit être dirigée. La requête ne sera acheminée vers ce service qu'après vérification de la validité de l'en-tête, des revendications du jeton d'authentification, etc. Valeur par défaut : 1.| \| x-xbl-contract-version| entier non signé de 32 bits| S'il est présent et défini à 2, la version V2 de cette API sera utilisée. Sinon, la V1.| \| Accept-Language| chaîne| Liste des paramètres régionaux souhaités et des solutions de repli (p. ex., fr-FR, fr, en-GB, en-WW, en-US). Le service Achievements parcourt la liste jusqu'à ce qu'il trouve des chaînes localisées correspondantes. S'il n'en trouve aucune, il tente de faire correspondre l'emplacement défini dans le jeton de l'utilisateur, qui provient de l'adresse IP de l'utilisateur. Si aucune chaîne localisée correspondante n'est encore trouvée, il utilise les chaînes par défaut fournies par le développeur ou l'éditeur du titre. | ## Corps de la requête Aucun objet n'est envoyé dans le corps de cette requête. ## Corps de la réponse Si l'appel réussit, le service retourne un tableau d'objets [Achievement (JSON)](/fr-CA/reference/live/rest/json/json-achievementv2) et un objet [PagingInfo (JSON)](/fr-CA/reference/live/rest/json/json-paginginfo). ### Exemple de réponse ```cpp theme={null} { "achievements": [{ "id":"3", "serviceConfigId":"b5dd9daf-0000-0000-0000-000000000000", "name":"Default NameString for Microsoft Achievements Sample Achievement 3", "titleAssociations": [{ "name":"Microsoft Achievements Sample", "id":3051199919, "version":"abc" }], "progressState":"Achieved", "progression": { "achievementState":"Achieved", "requirements":null, "timeUnlocked":"2013-01-17T03:19:00.3087016Z", }, "mediaAssets": [{ "name":"Icon Name", "type":"Icon", "url":"http://www.xbox.com" }], "platform":"D", "isSecret":true, "description":"Default DescriptionString for Microsoft Achievements Sample Achievement 3", "lockedDescription":"Default UnachievedString for Microsoft Achievements Sample Achievement 3", "productId":"12345678-1234-1234-1234-123456789012", "achievementType":"Challenge", "participationType":"Individual", "timeWindow": { "startDate":"2013-02-01T00:00:00Z", "endDate":"2100-07-01T00:00:00Z" }, "rewards": [{ "name":null, "description":null, "value":"10", "type":"Gamerscore", "valueType":"Int" }, { "name":"Default Name for InAppReward for Microsoft Achievements Sample Achievement 3", "description":"Default Description for InAppReward for Microsoft Achievements Sample Achievement 3", "value":"1", "type":"InApp", "valueType":"String" }], "estimatedTime":"06:12:14", "deeplink":"aWFtYWRlZXBsaW5r", "isRevoked":false }], "pagingInfo": { "continuationToken":null, "totalRecords":1 } } ``` ## Voir aussi ##### Parent [/users/xuid({xuid})/achievements](/fr-CA/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsv2) ##### Référence [Achievement (JSON)](/fr-CA/reference/live/rest/json/json-achievementv2) [PagingInfo (JSON)](/fr-CA/reference/live/rest/json/json-paginginfo) [Paramètres de pagination](/fr-CA/reference/live/rest/additional/pagingparameters) ## Related topics - [XblAchievementsGetAchievementAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementasync.md) - [XblAchievementsGetAchievementsForTitleIdAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)