Skip to main content

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

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

​
Comentarios

Quita elementos de una lista. 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 (la lista permanecerá pero 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. 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| Cero o un entero positivo. Los números no tienen que ser contiguos. Por ejemplo, el parámetro de consulta indexes=1,8 quitará los elementos de los índices 1 y 8. Si no se especifica ningún índice, se elimina toda la lista.|

​
Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío para esta llamada.

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

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

Si la llamada se realiza correctamente, el servicio devuelve los metadatos más recientes de la lista.

​
Ejemplo de respuesta

​
Consulte también

Elemento primario
Referencia de identificadores uniformes de recursos (URI)
Last modified on October 19, 2026