Skip to main content

​
DELETE (/users/xuid(xuid)/lists/PINS/)

Quita elementos de una lista. El dominio de estos URI es eplists.xboxlive.com.

​
Comentarios

Los elementos que se van a quitar se indican mediante su índice en la lista y se identifican en el parámetro de cadena de consulta indexes. La lista de índices debe estar delimitada por comas y solo se pueden pasar 100 índices en una única llamada. Sin embargo, si no se pasa ningún índice (parámetro de cadena de consulta vacío), se eliminará el contenido de toda la lista (permanecerá una lista vacía y el número de versión seguirá incrementándose). Una vez quitados los elementos, la lista se “compacta” de modo que no queden huecos en el orden de los índices. Por lo tanto, esta llamada no es idempotente. Esta llamada requiere que se incluya un encabezado If-Match:versionNumber en la solicitud, donde versionNumber es el número de versión actual del archivo. Si no se incluye, o no coincide con el número de versión actual de la lista, se devolverá un código de estado HTTP 412 (error de condición previa) 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

​
Parámetros de cadena de consulta

| Parámetro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | | indexes| string| Opcional. Especifica dónde quitar elementos. Valores admitidos: 0, enteros positivos y “end”. Valor predeterminado: 0.| Ejemplo: indexes=1,8 quita los elementos de los índices 1 y 8. Los índices deben ser únicos. Si no se proporciona ningún índice, se borrará toda la lista.

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

​
Encabezados de solicitud obligatorios

| Encabezado| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| Contiene el token STS que se usa para autenticar y autorizar la solicitud. Debe ser un token del servicio XSTS e incluir el XUID como una de las notificaciones. | | X-XBL-Contract-Version| Especifica qué versión de la API se solicita (enteros positivos). Pins admite la versión 2. Si falta este encabezado o el valor no se admite, el servicio devolverá un 400 - Bad request con “Unsupported or missing contract version header” en la descripción del estado.| | Content-Type| Especifica si el contenido de los cuerpos de solicitud/respuesta estará en json o xml. Los valores admitidos son “application/json” y “application/xml”| | If-Match| Este encabezado debe contener el número de versión actual de una lista al realizar solicitudes de modificación. Las solicitudes de modificación usan los verbos PUT, POST o DELETE. Si la versión del encabezado “If-Match” no coincide con la versión actual de la lista, la solicitud se rechazará con un código de retorno HTTP 412 - error de condición previa. (Opcional) También se puede usar para solicitudes GET; si está presente y la versión pasada coincide con la versión actual de la lista, no se devolverán datos de la lista y se devolverá un código HTTP 304 - Not Modified. |

​
Cuerpo de la solicitud

No se envía ningún objeto en el cuerpo de esta solicitud.

​
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 solicitud se completó correctamente. El cuerpo de la respuesta debe contener el recurso solicitado (para un GET). Las solicitudes POST y PUT recibirán metadatos actualizados de la lista (versión de la lista, recuento, etc.).| | 201| Created| Se ha creado una lista nueva. Se devuelve en la inserción inicial en una lista. La respuesta incluye metadatos actualizados de la lista y el encabezado de ubicación contiene el URI de la lista.| | 304| Not Modified| Se devuelve en solicitudes GET. Indica que el cliente tiene la versión más reciente de la lista. El servicio compara el valor del encabezado If-Match con la versión de la lista. Si son iguales, se devuelve un 304 sin datos.| | 400| Bad Request| La solicitud tenía un formato incorrecto. Podría ser un valor o tipo no válido para un parámetro de URI o de cadena de consulta. También puede ser el resultado de la falta de un parámetro o valor de datos obligatorio, o de que la solicitud indicara una versión de la API que falta o no es válida. Consulte el encabezado X-XBL-Contract-Version.| | 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| El autor de la llamada no tiene acceso al recurso. Esto indica que no se ha creado tal lista.| | 412| Precondition Failed| Indica que la versión de la lista ha cambiado y que una solicitud de modificación ha fallado. Una solicitud de modificación es una inserción, actualización o eliminación. El servicio comprueba el encabezado If-Match para la versión de la lista. Si no coincide con la versión actual de la lista, la operación falla y se devuelve este código junto con los metadatos actuales de la lista (que incluyen la versión actual).| | 500| Internal Server Error| El servicio rechaza la solicitud debido a un error del lado del servidor.| | 501| Not Implemented| El autor de la llamada solicitó un URI que no se ha implementado en el servidor. (Actualmente solo se usa cuando se realiza una solicitud para un nombre de lista que no está en la lista de permitidos).| | 503| Service Unavailable| El servidor rechaza la solicitud, normalmente debido a una carga excesiva. Después de un retraso (consulte el encabezado Retry-after), la solicitud se puede reintentar.|

​
Cuerpo de la respuesta

​
Ejemplo de respuesta

​
Consulte también

Elemento primario
/users/xuid(xuid)/lists/PINS/
Last modified on October 19, 2026