> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /titles/{titleId}/activities/query

> Get Activity Batch

# Get Activity Batch

사용자 목록에 대한 멀티플레이어 활동 배치를 가져옵니다.

이 API를 통해 클라이언트 및 서비스는 사용자 목록에 대한 활동 배치를 가져올 수 있습니다.

이 API는 부분 결과를 반환할 수 있습니다. 특정 사용자는 전체 활동 세트를 가지지만, 일부 사용자는 활동이 전혀 없을 수 있습니다. 사용자 하위 집합에 대한 활동이 발견되면 해당 활동이 반환됩니다. 활동을 찾을 수 없는 사용자의 경우 해당 사용자에 대해 빈 목록이 반환됩니다. 내부 오류로 인해 활동을 가져올 수 없는 사용자의 경우 해당 사용자에 대해 null이 반환됩니다. 이 경우 클라이언트는 호출을 재시도해야 합니다. 즉, 사용자는 활동 목록, 빈 목록 또는 null을 가질 수 있습니다.

```http theme={null}
POST /titles/{titleId}/activities/query
```

## URI 매개 변수

| 매개 변수 | 위치 | 필수 | 형식 | 설명 |
| - | - | - | - | - |
| titleId | path | TRUE | integer | 요청이 전송되는 게임의 titleId입니다. |

## 요청 본문

| 이름 | 필수 | 형식 | 설명 |
| - | - | - | - |
| users | TRUE | string\[] | 활동 정보를 검색해야 하는 사용자의 ID입니다. 최대 30명의 사용자가 지원됩니다. |

## 요청 헤더

| 이름 | 필수 | 형식 | 설명 |
| - | - | - | - |
| Authorization | TRUE | integer | 호출자는 XBL 3.0 권한 부여 형식으로 XToken을 제공해야 합니다. 예: Authorization: XBL3.0 x=2553948354698;>encrypted token \<) |
| Content-Type | TRUE | string | ContentType은 application/json으로 설정해야 합니다. |

## 응답

| 이름 | 형식 | 설명 |
| - | - | - |
| 200 OK | [GetActivityBatchResponse](#getactivitybatchresponse) | 반환 개체에는 각 사용자에 대한 활동 목록이 포함됩니다. 사용자에게 현재 활동이 없는 경우, 해당 사용자의 활동 목록은 비어 있습니다. 사용자의 활동을 가져오는 데 서비스 문제가 있는 경우, 해당 사용자의 활동 목록은 null이 됩니다. |
| 400 Bad Request | [ErrorResponse](#errorresponse) | 요청 처리 중에 오류가 발생했습니다. 가능한 오류 코드: “InvalidRequest - The request payload is invalid.”, “ AuthorizationError: The caller is not allowed to access the resource.” |
| Other Status Codes | [ThrottledEntity](#throttledentity) | 너무 많은 요청. Headers Retry-After: integer |

## 정의

* [ErrorResponse](#errorresponse)
* [GetActivityBatchRequest](#getactivitybatchrequest)
* [GetActivityBatchResponse](#getactivitybatchresponse)
* [GetActivityResponse](#getactivityresponse)
* [JoinRestriction](#joinrestriction)
* [Platform](#platform)
* [ThrottledEntity](#throttledentity)
* [UserActivity](#useractivity)

### ErrorResponse

| 이름 | 형식 | 설명 |
| - | - | - |
| debugMessage | string | 디버깅에 사용할 수 있는 사람이 읽을 수 있는 형태의 오류 메시지입니다. |
| errorCode | string | 오류 코드 열거형입니다. |

### GetActivityBatchRequest

| 이름 | 형식 | 설명 |
| - | - | - |
| users | string\[] | 활동 정보를 검색해야 하는 사용자의 ID입니다. 최대 30명의 사용자가 지원됩니다. |

### GetActivityBatchResponse

| 이름 | 형식 | 설명 |
| - | - | - |
| userActivities | [UserActivity](#useractivity)\[] | |

### GetActivityResponse

| 이름 | 형식 | 설명 |
| - | - | - |
| connectionString | string | 연결 문자열은 게임에 참여하기 위해 접속하는 클라이언트에 전달되는 개체입니다. 연결 문자열에는 일반적으로 참여하는 사용자가 연결할 수 있도록 서버 IP와 같은 정보가 포함됩니다. 연결 문자열의 길이는 512자로 제한됩니다. |
| currentPlayers | integer | 멀티플레이어 활동에서 사용자와 함께 플레이 중인 플레이어 수입니다. |
| groupId | string | 동일한 게임의 일부로 플레이하는 모든 사용자를 그룹화하기 위한 고유 식별자입니다. |
| joinRestriction | [JoinRestriction](#joinrestriction) | 현재 플레이어에 참여할 수 있는 대상을 결정하는 설정입니다. |
| maxPlayers | integer | 현재 활동에서 이 플레이어와 함께 플레이할 수 있는 최대 플레이어 수입니다. |
| platform | [Platform](#platform) | |
| sequenceNumber | string | 이는 클라이언트가 각 요청마다 전달해야 하는 단조롭게 증가하는 숫자(ulong)의 문자열 표현입니다. 활동에 대한 업데이트 순서를 보장하는 데 사용됩니다. sequenceNumber의 좋은 예는 항상 증가하도록 보장되는 클라이언트의 유닉스 시간입니다. 0보다 커야 하며, ulong의 최대값보다 클 수 없습니다. |
| titleId | integer | 활동이 요청된 게임의 titleId입니다. |

### JoinRestriction

| 이름 | 형식 | 설명 |
| - | - | - |
| Followed | string | |
| InviteOnly | string | |
| Public | string | |

### Platform

| 이름 | 형식 | 설명 |
| - | - | - |
| Android | string | |
| IOS | string | |
| Nintendo | string | |
| PlayStation | string | |
| Scarlett | string | |
| Win32 | string | |
| WindowsOneCore | string | |
| XboxOne | string | |

### ThrottledEntity

| 이름 | 형식 | 설명 |
| - | - | - |
| currentRequests | string | 현재 요청 수 - 동시성 또는 요청률입니다. |
| debugMessage | string | 디버깅에 사용할 수 있는 사람이 읽을 수 있는 형태의 스로틀 메시지입니다. |
| limitType | string | 제한 형식으로, 동시성 또는 요청률입니다. |
| maxRequests | string | 허용되는 최대 요청 수 - 동시성 또는 요청률입니다. |
| periodInSeconds | string | 요청률 또는 동시성 제한이 초과될 때 적용되는 기간(초 단위)입니다. |
| version | string | 현재 스로틀 계약 버전입니다. |

### UserActivity

| 이름 | 형식 | 설명 |
| - | - | - |
| activities | [GetActivityResponse](#getactivityresponse)\[] | |
| userId | string | |


## Related topics

- [POST /titles/{titleId}/recentplayers](https://devdocs.xbox.com/ko/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostUniRecentPlayers.md)
- [POST /titles/{titleId}/invites](https://devdocs.xbox.com/ko/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-SendInvite.md)
- [POST /titles/{titleId}/recentplayergroups/server](https://devdocs.xbox.com/ko/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostServerRecentPlayerGroup.md)
- [POST /titles/{titleId}/recentplayers/server](https://devdocs.xbox.com/ko/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-PostServerUniRecentPlayers.md)
- [POST /titles/{titleId}/invites/server API](https://devdocs.xbox.com/ko/reference/live/rest/uri/multiplayeractivity/swagger-uris/uri-SendServerInvite.md)