Saltar al contenido principal

POST (/users/xuid()/achievements//update)

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

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

Autorización

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

Ejemplo de solicitud

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

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. | 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()/achievements//update
Última modificación el 19 de octubre de 2026