Skip to main content

​
POST /users/xuid(xuid)/lists/PINS//ContainsItems

Determina si una lista contiene un conjunto de elementos (especificados por itemId) sin recuperar la lista completa. El dominio de estos URI es eplists.xboxlive.com.

​
Comentarios

Este punto de conexión permite al autor de la llamada determinar si uno o varios elementos existen en la lista especificada sin obtener realmente la lista y buscar por sí mismo. El conjunto de elementos se identifica mediante itemId (o la combinación provider/providerId) y los datos devueltos son los datos pasados junto con un valor booleano true o false que indica si la lista contiene cada elemento.

​
Parámetros de URI

​
Parámetros de cadena de consulta

No se admiten parámetros de consulta.

​
Cuerpo de la 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 nueva lista. Se devuelve en la inserción inicial en una lista. La respuesta incluye metadatos actualizados de la lista y el encabezado location contiene el URI de la lista.| | 304| Not Modified| Se devuelve en los 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. Puede tratarse de 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 ausente o no 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 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. Tras un retraso (consulte el encabezado Retry-after), se puede reintentar la solicitud. |

​
Encabezados de solicitud obligatorios

| Encabezado| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| Contiene el token de 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 es compatible, 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 - precondition failed. (opcional) También se puede usar para los 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, se devuelve la lista de elementos, junto con un valor booleano para cada elemento que especifica si el elemento está en la lista o no.

​
Ejemplo de respuesta

​
Consulte también

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