> ## 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/{scid}/{achievementid})

> GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})

# GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})

Obtient les détails du succès.
Le domaine de ces URI est `achievements.xboxlive.com`.

* [Paramètres d'URI](#ID4EV)
* [Autorisation](#ID4EAB)
* [Effet des paramètres de confidentialité sur la ressource](#ID4E4C)
* [En-têtes de requête obligatoires](#ID4EPG)
* [En-têtes de requête facultatifs](#ID4EPH)
* [Corps de la requête](#ID4ECBAC)
* [Codes d'état HTTP](#ID4ENBAC)
* [Corps de la réponse](#ID4EBGAC)

<a id="ID4EV" />

## 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é. |
| scid | GUID | Identifiant unique de la configuration de service dont le succès est consulté. |
| achievementid | entier non signé de 32 bits | Identifiant unique (au sein du SCID spécifié) du succès consulté. |

<a id="ID4EAB" />

## Autorisation

Revendications d'autorisation utilisées | Revendication| Obligatoire?| Description| Comportement si absent|
\| --- | --- | --- | --- | --- | --- | --- |
\| Utilisateur| Oui| Un utilisateur valide sur XBOX LIVE pour lequel la requête est effectuée.| 403 Interdit|
\| Titre| Non| Le titre appelant.| Dépend d'AuthZ. Depuis le 1er mai 2013, AuthZ ne fournit pas de revendication en cas d'absence et refuse donc l'accès à tout SCID non marqué comme public.|
\| Sandbox| Non| Le sandbox à partir duquel les résultats doivent être récupérés.| Dépend d'AuthZ. Depuis le 1er mai 2013, AuthZ ne fournit pas de revendication par défaut en cas d'absence.|

<a id="ID4E4C" />

## Effet des paramètres de confidentialité sur la ressource

Effet des paramètres de confidentialité sur la ressource | Utilisateur demandeur| Paramètre de confidentialité de l'utilisateur cible| Comportement|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| moi| -| Tel que décrit.|
\| ami| tout le monde| OK|
\| ami| amis seulement| OK|
\| ami| bloqué| Interdit.|
\| utilisateur non ami| tout le monde| OK|
\| utilisateur non ami| amis seulement| Interdit.|
\| utilisateur non ami| bloqué| Interdit.|
\| site tiers| tout le monde| OK|
\| site tiers| amis seulement| Interdit.|
\| site tiers| bloqué| Interdit.|

<a id="ID4EPG" />

## 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=\<userhash>;\<token>".|

<a id="ID4EPH" />

## 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, et ainsi de suite. Valeur par défaut : 1.|
\| x-xbl-contract-version| chaîne| La valeur par défaut est 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. |

<a id="ID4ECBAC" />

## Corps de la requête

Aucun objet n'est envoyé dans le corps de cette requête.

<a id="ID4ENBAC" />

## Codes d'état HTTP

Le service retourne l'un des codes d'état de cette section en réponse à une requête effectuée avec cette méthode sur cette ressource. Pour obtenir la liste complète des codes d'état HTTP standard utilisés avec les services XBOX Live, consultez [Codes d'état HTTP standard](/fr-CA/reference/live/rest/additional/httpstatuscodes).

\| Code| Phrase de motif| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| La session a été récupérée avec succès.|
\| 301| Déplacé de façon permanente| Le service a été déplacé vers un URI différent.|
\| 307| Redirection temporaire| L'URI de cette ressource a été modifié temporairement.|
\| 400| Requête incorrecte| Le service n'a pas pu comprendre la requête mal formée. Il s'agit généralement d'un paramètre non valide.|
\| 401| Non autorisé| La requête nécessite l'authentification de l'utilisateur.|
\| 403| Interdit| La requête n'est pas autorisée pour l'utilisateur ou le service.|
\| 404| Introuvable| La ressource spécifiée est introuvable.|
\| 406| Non acceptable| La version de la ressource n'est pas prise en charge; elle devrait être rejetée par la couche MVC.|
\| 408| Délai d'attente de la requête dépassé| La requête a pris trop de temps à s'exécuter.|
\| 410| Supprimé| La ressource demandée n'est plus disponible.|

<a id="ID4EBGAC" />

## Corps de la réponse

<a id="ID4EHGAC" />

### Exemple de réponse

```cpp theme={null}
{
    "achievement":
    {
        "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":
        {
                "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
    }
}
         
```

<a id="ID4ERGAC" />

## Voir aussi

<a id="ID4ETGAC" />

##### Parent

[/users/xuid({xuid})/achievements/{scid}/{achievementid}](/fr-CA/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid)


## Related topics

- [XblAchievementsGetAchievementAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementasync.md)
- [XblAchievementsGetAchievementsForTitleIdAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
