> ## 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.

# POST (/users/xuid({xuid})/achievements/{scid}/update)

> POST (/users/xuid({xuid})/achievements/{scid}/update)

# POST (/users/xuid({xuid})/achievements/{scid}/update)

Met à jour la progression d'un succès.
Le domaine de ces URI est `achievements.xboxlive.com`.

* [Paramètres d'URI](#ID4EV)
* [Autorisation](#ID4EAB)
* [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)

## Remarques

* Un appel réussi retourne un code d'état HTTP 200 avec un corps de réponse vide.
* Si l'appel n'entraîne aucune modification de la progression du succès (c.-à-d. qu'il est déjà déverrouillé ou au même pourcentage d'achèvement), l'appel retourne un code d'état HTTP 304 avec un corps de réponse vide.

<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é. |

<a id="ID4EAB" />

## Autorisation

| Revendication | Obligatoire? | Description | Comportement si absent |
| - | - | - | - |
| Utilisateur | Oui | Un utilisateur valide sur XBOX LIVE pour lequel la requête est effectuée. | 403 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>".|
\| x-xbl-contract-version| 2| Version du contrat d'API.|

<a id="ID4EPH" />

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

\| En-tête| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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

Un objet [AchievementUpdateRequest (JSON)](/fr-CA/reference/live/rest/json/json-achievementupdaterequest).

<a id="ID4EPB" />

### Exemple de requête

`POST /users/xuid({2810000000000000})/achievements/{00000000-0000-0000-0000-000000000000}/update`

```json theme={null}
{
    "action": "progressUpdate",
    "serviceConfigId": "00000000-0000-0000-0000-000000000000",
    "titleId": 0000000000,
    "userId": "2810000000000000",
    "achievements": [
        {
            "id": "1",
            "percentComplete": 100
        }
    ]
}
```

<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.|
\| 304| Non modifié| La progression du succès n'a pas été modifiée.|
\| 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

Le corps de la réponse est vide.

## Voir aussi

##### Parent

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


## Related topics

- [XblAchievementsUpdateAchievementAsync](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XblAchievementsManagerUpdateAchievement](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)