> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # POST (/serviceconfigs/{scid}/batch) > POST (/serviceconfigs/{scid}/batch) # POST (/serviceconfigs/{scid}/batch) Crea una consulta por lotes sobre varios identificadores de usuario de XBOX para la configuración de servicio. > **Importante:**\ > Este método lo usa el multijugador de 2015 y se aplica únicamente a esa versión multijugador y posteriores. Está pensado para usarse con el contrato de plantilla 104/105 o posterior, y requiere un elemento de encabezado X-Xbl-Contract-Version: 104/105 o posterior en cada solicitud. * [Comentarios](#ID4ET) * [Parámetros de URI](#ID4ELB) * [Parámetros de cadena de consulta](#ID4EVB) * [Códigos de estado HTTP](#ID4EGF) * [Cuerpo de la solicitud](#ID4ENF) * [Cuerpo de la respuesta](#ID4EWF) ## Comentarios Este método HTTP/REST crea consultas por lotes sobre varios identificadores de usuario de XBOX en el nivel del ID de configuración de servicio (SCID). Este método puede encapsularse mediante **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync**. Para el multijugador de 2015, puede combinar muchas consultas en una sola llamada si todas las consultas son iguales pero se refieren a diferentes identificadores de usuario de XBOX (XUID), tal como se representa en el parámetro de cadena de consulta *xuid*. Tenga en cuenta que los parámetros de cadena de consulta, y las respuestas, son los mismos para las consultas normales y las consultas por lotes. Para una consulta por lotes, las sesiones que pertenecen a cada XUID se escriben en la respuesta en el mismo orden en que se presentan los parámetros *xuid* en la solicitud. Es posible que la misma sesión aparezca varias veces en la respuesta, una por cada *xuid* con el que coincida. ## Parámetros de URI \| Parámetro| Tipo| Descripción| \| --- | --- | --- | --- | \| scid| GUID| Identificador de configuración de servicio (SCID). Parte 1 del identificador de sesión.| ## Parámetros de cadena de consulta Una consulta puede modificarse mediante los parámetros de cadena de consulta de la tabla siguiente. \| **Parámetro**| **Tipo**| **Descripción**| \| --- | --- | --- | --- | --- | --- | --- | \| keyword| string| Una palabra clave, por ejemplo, "foo", que debe encontrarse en las sesiones o plantillas para que se recuperen. | \| xuid| Entero de 64 bits sin signo| El identificador de usuario de XBOX, por ejemplo, "123", de las sesiones que se incluirán en la consulta. De forma predeterminada, el usuario debe estar activo en la sesión para que esta se incluya. | \| reservations| Valor booleano| True para incluir las sesiones en las que el usuario está establecido como jugador reservado pero no se ha unido para convertirse en jugador activo. Este parámetro solo se usa al consultar sus propias sesiones, o al consultar las sesiones de un usuario específico de servidor a servidor. | \| inactive| Valor booleano| True para incluir las sesiones que el usuario ha aceptado pero en las que no está jugando activamente. Las sesiones en las que el usuario está "ready" pero no "active" cuentan como inactivas. | \| private| Valor booleano| True para incluir las sesiones privadas. Este parámetro solo se usa al consultar sus propias sesiones, o al consultar las sesiones de un usuario específico de servidor a servidor. | \| visibility| string| Estado de visibilidad de las sesiones. Los valores posibles los define **MultiplayerSessionVisibility**. Si este parámetro se establece en "open", la consulta debe incluir solo las sesiones abiertas. Si se establece en "private", el parámetro *private* debe establecerse en true. | \| version| Entero de 32 bits con signo| La versión máxima de sesión que debe incluirse. Por ejemplo, un valor de 2 especifica que solo deben incluirse las sesiones con una versión principal de sesión de 2 o inferior. El número de versión debe ser menor o igual que la versión del contrato de la solicitud módulo 100. | \| take| Entero de 32 bits con signo| El número máximo de sesiones que se recuperarán. Este número debe estar entre 0 y 100. | Establecer *private* o *reservations* en true requiere acceso de nivel de servidor a la sesión. Como alternativa, estas configuraciones requieren que la notificación XUID del autor de la llamada coincida con el filtro XUID del URI. De lo contrario, se devuelve el código de estado HTTP/403, existan o no realmente dichas sesiones. ## Códigos de estado HTTP El servicio devuelve un código de estado HTTP según se aplica al MPSD. ## Cuerpo de la solicitud ```cpp theme={null} { "xuids": [ "1234", "5678" ] } ``` ## Cuerpo de la respuesta Lo que devuelve este método es una matriz JSON de referencias de sesión, con algunos datos de sesión incluidos en línea. ```cpp theme={null} { "results": [ { "xuid": "9876", // If the session was found from a xuid, that xuid. "startTime": "2009-06-15T13:45:30.0900000Z", "sessionRef": { "scid": "foo", "templateName": "bar", "name": "session-seven" }, "accepted": 4, // Approximate number of non-reserved members. "status": "active", // or "reserved" or "inactive". This is the state of the user in the session, not the session itself. Only present if the session was found using a xuid. "visibility": "open", // or "private", "visible", or "full" "joinRestriction": "local", // or "followed". Only present if 'visibility' is "open" or "full" and the session has a join restriction. "myTurn": true, // Not present is the same as 'false'. Only present if the session was found using a xuid. "keywords": [ "one", "two" ] } ] } ``` ## Consulte también ##### Elemento primario [/serviceconfigs/{scid}/batch](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch.md) ## Related topics - [/serviceconfigs/{scid}/batch](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch.md) - [POST (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch)](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigscidsessiontemplatessessiontemplatenamebatchpost.md) - [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch](https://docs.xbox.com/es/reference/live/rest/uri/sessiondirectory/uri-serviceconfigscidsessiontemplatessessiontemplatenamebatch.md) - [POST (/untrustedplatform/users/batch/scids/{scid}/data/{pathAndFileName},{type})](https://docs.xbox.com/es/reference/live/rest/uri/storage/uri-untrustedplatformusersbatchscidssciddatapathandfilenametype-post.md) - [POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)](https://docs.xbox.com/es/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype-post.md)