> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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)

Actualiza el progreso de un logro.
El dominio de estos URI es `achievements.xboxlive.com`.

* [Parámetros de URI](#ID4EV)
* [Autorización](#ID4EAB)
* [Encabezados de solicitud obligatorios](#ID4EPG)
* [Encabezados de solicitud opcionales](#ID4EPH)
* [Cuerpo de la solicitud](#ID4ECBAC)
* [Códigos de estado HTTP](#ID4ENBAC)
* [Cuerpo de la respuesta](#ID4EBGAC)

## Comentarios

* Una llamada correcta devolverá un código de estado HTTP 200 con un cuerpo de respuesta vacío.
* Si la llamada no produce ningún cambio en el progreso del logro (es decir, ya está desbloqueado o tiene el mismo porcentaje de finalización), la llamada devolverá un código de estado HTTP 304 con un cuerpo de respuesta vacío.

## Parámetros de URI

| Parámetro | Tipo | Descripción |
| - | - | - |
| xuid | Entero de 64 bits sin signo | Identificador de usuario de XBOX (XUID) del usuario a cuyo recurso se accede. Debe coincidir con el XUID del usuario autenticado. |
| scid | GUID | Identificador único de la configuración de servicio a cuyo logro se accede. |

## Autorización

| Notificación | ¿Obligatoria? | Descripción | Comportamiento si falta |
| - | - | - | - |
| User | Sí | Un usuario válido en XBOX LIVE para el que se realiza la solicitud. | 403 Forbidden |

## Encabezados de solicitud obligatorios

\| Encabezado| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| Credenciales de autenticación para la autenticación HTTP. Valor de ejemplo: "XBL3.0 x=\<userhash>;\<token>".|
\| x-xbl-contract-version| 2| Versión del contrato de la API.|

## Encabezados de solicitud opcionales

\| Encabezado| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Accept-Language| string| Lista de configuraciones regionales deseadas y alternativas (por ejemplo, fr-FR, fr, en-GB, en-WW, en-US). El servicio de logros recorrerá la lista hasta encontrar cadenas localizadas coincidentes. Si no encuentra ninguna, intenta hacer coincidir la ubicación definida en el token del usuario, que procede de la dirección IP del usuario. Si aun así no se encuentran cadenas localizadas coincidentes, usa las cadenas predeterminadas proporcionadas por el desarrollador o editor del título. |

## Cuerpo de la solicitud

Un objeto [AchievementUpdateRequest (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-achievementupdaterequest.md).

### Ejemplo de solicitud

`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
        }
    ]
}
```

## Códigos de estado HTTP

El servicio devuelve uno de los códigos de estado de esta sección en respuesta a una solicitud realizada con este método en este recurso. Para obtener una lista completa de los códigos de estado HTTP estándar que se usan con los servicios de XBOX Live, consulte [Códigos de estado HTTP estándar](https://docs.xbox.com/es/reference/live/rest/additional/httpstatuscodes.md).

\| Código| Frase de motivo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| La sesión se recuperó correctamente.|
\| 301| Moved Permanently| El servicio se ha movido a un URI diferente.|
\| 304| Not Modified| El progreso del logro no se modificó.|
\| 307| Temporary Redirect| El URI de este recurso ha cambiado temporalmente.|
\| 400| Bad Request| El servicio no pudo interpretar una solicitud con formato incorrecto. Normalmente, un parámetro no válido.|
\| 401| Unauthorized| La solicitud requiere autenticación del usuario.|
\| 403| Forbidden| La solicitud no está permitida para el usuario o el servicio.|
\| 404| Not Found| No se pudo encontrar el recurso especificado.|
\| 406| Not Acceptable| La versión del recurso no es compatible; la capa MVC debería rechazarla.|
\| 408| Request Timeout| La solicitud tardó demasiado en completarse.|
\| 410| Gone| El recurso solicitado ya no está disponible.|

## Cuerpo de la respuesta

El cuerpo de la respuesta está vacío.

## Consulte también

##### Elemento primario

[/users/xuid({xuid})/achievements/{scid}/update](https://docs.xbox.com/es/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate.md)


## Related topics

- [/users/xuid({xuid})/achievements/{scid}/update](https://docs.xbox.com/es/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate.md)
- [/users/xuid({xuid})/achievements/{scid}/{achievementid}](https://docs.xbox.com/es/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid.md)
- [GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})](https://docs.xbox.com/es/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementidget.md)
- [/users/xuid({xuid})/achievements](https://docs.xbox.com/es/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsv2.md)
- [GET (/users/xuid({xuid})/achievements)](https://docs.xbox.com/es/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsgetv2.md)