Skip to main content

GET (/serviceconfigs//sessiontemplates//sessions)

세션 템플릿 문서를 검색합니다.
중요:
이 URI 메서드는 모든 요청에 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다.

설명

이 HTTP/REST 메서드는 제공된 필터에 대한 세션 템플릿 정보를 검색합니다. 이 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsAsync로 래핑될 수 있습니다.
참고:
2015 멀티플레이어의 경우 이 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync에서 호출합니다.
참고:
이 메서드에 대한 모든 호출에는 키워드, XBOX 사용자 ID 필터 또는 둘 다가 포함되어야 합니다. 호출자에게 private 및 reservations 매개 변수에 대한 올바른 권한이 없는 경우 메서드는 실제로 이러한 세션이 존재하는지 여부에 관계없이 오류 코드 403 Forbidden을 반환합니다.

URI 매개 변수

| 매개 변수| 형식| 설명| | --- | --- | --- | --- | --- | --- | | scid| GUID| 서비스 구성 식별자(SCID). 세션 ID의 파트 1입니다.| | keyword| string| 결과를 해당 문자열로 식별된 세션으로만 필터링하는 데 사용되는 키워드입니다.| | xuid| GUID| 세션을 검색할 사용자의 XBOX 사용자 ID입니다. 사용자는 세션에서 활성 상태여야 합니다. | | reservations| string| 사용자가 수락하지 않은 세션이 세션 목록에 포함되는지 여부를 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. 이 설정에는 호출자가 세션에 대한 서버 수준 액세스 권한이 있거나 호출자의 XUID 클레임이 XBOX 사용자 ID 필터와 일치해야 합니다. | | inactive| string| 사용자가 수락했지만 활발히 플레이하지 않은 세션이 세션 목록에 포함되는지 여부를 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. | | private| string| 프라이빗 세션이 세션 목록에 포함되는지 여부를 나타내는 값입니다. 이 매개 변수는 true로만 설정할 수 있습니다. 자신의 세션을 쿼리하거나 서버 대 서버로 쿼리할 때만 유효합니다. 이 매개 변수를 true로 설정하려면 호출자가 세션에 대한 서버 수준 액세스 권한이 있거나 호출자의 XUID 클레임이 XBOX 사용자 ID 필터와 일치해야 합니다. | | visibility| string| 결과 필터링에 사용되는 표시 상태를 나타내는 열거형 값입니다. 현재 이 매개 변수는 open 세션을 포함하기 위해 Open으로만 설정할 수 있습니다. MultiplayerSessionVisibility를 참조하십시오. | | version| string| 포함할 세션의 주 세션 버전 또는 그 이하를 나타내는 양의 정수입니다. 이 값은 요청의 계약 버전 modulo 100 이하여야 합니다. | | take| string| 검색할 최대 세션 수를 나타내는 양의 정수입니다.|

HTTP 상태 코드

서비스는 MPSD에 적용되는 HTTP 상태 코드를 반환합니다.

요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

응답 본문

이 메서드의 반환은 인라인으로 포함된 일부 세션 데이터가 있는 세션 참조의 JSON 배열입니다.

함께 보기

상위
/serviceconfigs//sessiontemplates//sessions
Last modified on October 19, 2026