> ## 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é 64 bits | ID utilisateur XBOX (XUID) de l'utilisateur dont la ressource est consultée. Doit correspondre au XUID de l'utilisateur authentifié. |
| scid | GUID | Identificateur unique de la configuration de service dont le succès est consulté. |
| achievementid | entier non signé 32 bits | Identificateur unique (au sein du SCID spécifié) du succès consulté. |

<a id="ID4EAB" />

## Autorisation

Revendications d'autorisation utilisées | Revendication| Obligatoire ?| Description| Comportement en cas d'absence|
\| --- | --- | --- | --- | --- | --- | --- |
\| User| Oui| Utilisateur valide sur XBOX LIVE pour lequel la requête est effectuée.| 403 Forbidden|
\| Title| Non| 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 à tous les SCID non marqués comme publics.|
\| Sandbox| Non| Bac à sable à 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| -| Comme décrit.|
\| ami| tout le monde| OK|
\| ami| amis uniquement| OK|
\| ami| bloqué| Interdit.|
\| utilisateur non ami| tout le monde| OK|
\| utilisateur non ami| amis uniquement| Interdit.|
\| utilisateur non ami| bloqué| Interdit.|
\| site tiers| tout le monde| OK|
\| site tiers| amis uniquement| Interdit.|
\| site tiers| bloqué| Interdit.|

<a id="ID4EPG" />

## En-têtes de requête obligatoires

\| En-tête| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| 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| string| Nom/numéro de build du service XBOX LIVE vers lequel cette requête doit être dirigée. La requête n'est 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| string| La valeur par défaut est V1.|
\| Accept-Language| string| Liste des paramètres régionaux souhaités et des paramètres de secours (par exemple, 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 utilisateur, qui provient de l'adresse IP de l'utilisateur. S'il ne trouve toujours aucune chaîne localisée correspondante, il utilise les chaînes par défaut fournies par le développeur/é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/reference/live/rest/additional/httpstatuscodes).

\| Code| Expression de raison| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| La session a été récupérée avec succès.|
\| 301| Moved Permanently| Le service a été déplacé vers un autre URI.|
\| 307| Temporary Redirect| L'URI de cette ressource a temporairement changé.|
\| 400| Bad Request| Le service n'a pas pu comprendre la requête incorrecte. Il s'agit généralement d'un paramètre non valide.|
\| 401| Unauthorized| La requête nécessite l'authentification de l'utilisateur.|
\| 403| Forbidden| La requête n'est pas autorisée pour l'utilisateur ou le service.|
\| 404| Not Found| La ressource spécifiée est introuvable.|
\| 406| Not Acceptable| La version de la ressource n'est pas prise en charge ; elle doit être rejetée par la couche MVC.|
\| 408| Request Timeout| La requête a mis trop de temps à s'exécuter.|
\| 410| Gone| 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/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid)


## Related topics

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