PUT (/users/xuid(xuid)/lists/PINS/)
Actualiza los elementos de una lista según los índices especificados para cada elemento en el cuerpo de la solicitud. El dominio de estos URI eseplists.xboxlive.com.
- Comentarios
- Parámetros de URI
- Autorización
- Códigos de estado HTTP
- Encabezados de solicitud obligatorios
- Cuerpo de la solicitud
- Cuerpo de la respuesta
Comentarios
Esta llamada actualizará los elementos de una lista según los índices especificados para cada elemento en el cuerpo de la solicitud. Esta llamada no insertará elementos en la lista y, si no existen elementos en los índices especificados, la llamada devolverá un estado 400 Bad Request. Se pueden actualizar varios elementos en una sola llamada, pero todos deben existir en la lista actual. Es decir, se actualizan todos o no se actualiza ninguno. Esta llamada permitirá que el elemento que se va a actualizar se especifique mediante el itemId en lugar del index. Para ello, simplemente use “-1” como índice en la estructura IndexedItems que se envía al servicio. Obviamente, en este caso, el itemId no se puede cambiar como parte de la actualización, por lo que solo funcionará para cambios en otros campos de metadatos. La combinación provider/providerId se puede usar en lugar de itemId para identificar el elemento. Internamente, el servicio busca estos elementos en la lista y determina los índices adecuados que se van a actualizar. Si el elemento o los elementos no se encuentran, se devolverá un estado 400 Bad Request y no se actualizará ningún elemento. Esta llamada requiere que se incluya un encabezado If-Match:versionNumber en la solicitud si se usan índices para identificar los elementos. Si se usan identificadores de elemento para identificar los elementos (y la lista no admite duplicados), el encabezado If-Match es opcional. Si está presente, el encabezado If-Match siempre se validará. En el encabezado, versionNumber es el número de versión actual de la lista. Si no se incluye (y es obligatorio), o no coincide con el número de versión actual de la lista, se devolverá un código de estado HTTP 412 Precondition Failed y el cuerpo de la respuesta contendrá los metadatos más recientes de la lista, que incluyen el número de versión actual. Esto se hace para evitar que las actualizaciones de distintos clientes se sobrescriban entre sí.Parámetros de URI
Autorización
Esta llamada espera un token SAML de XSTS en el encabezado Authorization. Debe existir una notificación Xuid dentro de ese token SAML para identificar al autor de la llamada. Este valor se usa para determinar si el autor de la llamada tiene derechos de acceso a los datos de la lista en cuestión. La propia lista también se identificará mediante el Xuid y se incluirá en el URI de la lista. Con esto, es posible que en el futuro se admita el acceso compartido a las listas, pero por ahora no es una característica disponible. Actualmente, todas las listas a las que accede un usuario serán suyas y no existe acceso compartido. Por lo tanto, el Xuid del URI debe coincidir con el Xuid del token de notificaciones SAML.Nota:
Actualmente se admiten tanto los tokens de XBL Auth 2.0 como los de 3.0.