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

# 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://docs.xbox.com/ko/reference/live/rest/json/json-multiplayeractivitydetails.md)
* [MultiplayerSession (JSON)](https://docs.xbox.com/ko/reference/live/rest/json/json-multiplayersession.md)
* [MultiplayerSessionReference (JSON)](https://docs.xbox.com/ko/reference/live/rest/json/json-multiplayersessionreference.md)
* [MultiplayerSessionRequest (JSON)](https://docs.xbox.com/ko/reference/live/rest/json/json-multiplayersessionrequest.md)

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

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

## 핸들

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

## 이 섹션의 내용

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## 함께 보기

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

##### 상위

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


## Related topics

- [Multiplayer Session Directory 개요](https://docs.xbox.com/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Multiplayer Session Directory(MPSD)](https://docs.xbox.com/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-nav.md)
- [/serviceconfigs/{scid}/sessions](https://docs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessions.md)
- [Matchmaking URI](https://docs.xbox.com/ko/reference/live/rest/uri/matchtickets/atoc-reference-matchtickets.md)
- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions](https://docs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessions.md)
