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

# Session Directory URI

> Session Directory URIs

# Session Directory URIs

이 섹션에서는 MPSD(Multiplayer Session Directory)에 대한 XBOX Live Services의 URI(Universal Resource Identifier) 주소 및 연결된 HTTP(Hypertext Transport Protocol) 메서드에 대한 세부 정보를 제공합니다.

> **참고:**\
> XBOX 360, Windows Phone 장치 또는 Xbox.com에서 실행되는 게임 타이틀만 세션 디렉터리 URI를 사용할 수 있습니다.

* [도메인](#ID4EUB)
* [서비스 버전](#ID4EZB)
* [시스템 개체 및 속성](#ID4EAC)
* [핸들](#ID4EBE)

## 도메인

sessiondirectory.xboxlive.com

## 서비스 버전

이러한 REST URI의 호출자는 EDS(Entertainment Discovery Services)의 서비스 버전을 지정하는 HTTP 헤더인 X-Xbl-Contract-Version에 대해 104/105 이상의 값을 전달해야 합니다.

## 시스템 개체 및 속성

세션 및 템플릿의 구성을 위해 MPSD는 디렉터리에서 적용하고 해석하는 고정 스키마를 준수하는 여러 세션 JSON 개체를 사용합니다. 다양한 세션 디렉터리 URI에서 지원하는 메서드 호출 중에 이러한 개체는 지원되는 스키마에 따라 유효성 검사 및 병합됩니다. 멀티플레이어 구성과 관련된 주요 JSON 개체는 다음과 같습니다.

* [MultiplayerActivityDetails (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-multiplayeractivitydetails)
* [MultiplayerSession (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-multiplayersession)
* [MultiplayerSessionReference (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-multiplayersessionreference)
* [MultiplayerSessionRequest (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-multiplayersessionrequest)

특히 게임과 관련된 연결된 JSON 개체는 다음과 같습니다.

* [GameMessage (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-gamemessage)
* [GameResult (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-gameresult)
* [GameSession (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-gamesession)
* [GameSessionSummary (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-gamesessionsummary)

## 핸들

2015 멀티플레이어에서만 세션 핸들을 통해 세션에 액세스할 수 있습니다. 핸들을 지원하는 기능을 제공하기 위해 여러 URI가 추가되었습니다.

## 이 섹션의 내용

[/handles](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-handles)

  XBOX One 대시보드 사용자 환경에 표시할 사용자의 현재 활동에 대한 세션을 설정하고, 필요한 경우 세션 멤버를 초대하는 POST 작업을 지원합니다.

[/handles/{handleId}](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-handleshandleid)

  식별자로 지정된 세션 핸들에 대한 DELETE 및 GET 작업을 지원합니다.

[/handles/{handleId}/session](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession)

  핸들 역참조를 사용하는 세션에 대한 PUT 및 GET 작업을 지원합니다.

[/handles/query](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-handlesquery)

  세션 핸들에 대한 쿼리를 만드는 POST 작업을 지원합니다.

[/serviceconfigs/{scid}/batch](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch)

  서비스 구성 식별자 수준에서 일괄 쿼리에 대한 POST 작업을 지원합니다.

[/serviceconfigs/{scid}/sessions](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessions)

  세션 문서 집합을 검색하는 GET 작업을 지원합니다.

[/serviceconfigs/{scid}/sessiontemplates](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplates)

  MPSD 세션 템플릿 집합을 검색하는 GET 작업을 지원합니다.

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatename)

  세션 템플릿 이름 집합을 검색하는 GET 작업을 지원합니다.

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigscidsessiontemplatessessiontemplatenamebatch)

  세션 템플릿 수준에서 일괄 쿼리를 만드는 POST 작업을 지원합니다.

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessions)

  지정된 템플릿 이름의 세션 템플릿 집합을 검색하는 GET 작업을 지원합니다.

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionname)

  세션을 만들고 검색하는 PUT 및 GET 작업을 지원합니다.

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnamemembersme)

  세션 멤버를 제거하는 DELETE 작업을 지원합니다.

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/servers/{server-name}](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionnamemembersservername)

  지정된 세션의 서버를 제거하는 DELETE 작업을 지원합니다.

## 함께 보기

[Matchmaking URIs](https://devdocs.xbox.com/ko/reference/live/rest/uri/matchtickets/atoc-reference-matchtickets)

##### 상위

[URI(Universal Resource Identifier) 참조](https://devdocs.xbox.com/ko/reference/live/rest/uri/atoc-xboxlivews-reference-uris)


## Related topics

- [多人遊戲工作階段目錄概觀](https://devdocs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Multiplayer Session Directory](https://devdocs.xbox.com/fr-CA/services/xbox-services/multiplayer/mpsd/live-xbox-multiplayer-session-directory.md)
- [Multiplayer Session Directory 개요](https://devdocs.xbox.com/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Multiplayer Session Directory overview](https://devdocs.xbox.com/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Información general de Multiplayer Session Directory](https://devdocs.xbox.com/es/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
