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

# 工作階段目錄 URI

> 工作階段目錄 URI

# 工作階段目錄 URI

本節提供 XBOX Live 服務中多人遊戲工作階段目錄 (MPSD) 的統一資源識別碼 (URI) 位址及相關聯超文字傳輸通訊協定 (HTTP) 方法的詳細資料。

> **注意：**\
> 只有在 XBOX 360、Windows Phone 裝置或 Xbox.com 上執行的遊戲才能使用工作階段目錄 URI。

* [網域](#ID4EUB)
* [服務版本](#ID4EZB)
* [系統物件和屬性](#ID4EAC)
* [控制代碼](#ID4EBE)

## 網域

sessiondirectory.xboxlive.com

## 服務版本

這些 REST URI 的呼叫者必須為 X-Xbl-Contract-Version 傳遞 104/105 或更新的值，此 HTTP 標頭用於指定 Entertainment Discovery Services (EDS) 的服務版本。

## 系統物件和屬性

為了設定其工作階段和範本，MPSD 使用許多符合固定結構描述的工作階段 JSON 物件，這些結構描述由目錄強制執行並解譯。在呼叫各種工作階段目錄 URI 所支援的方法期間，會根據支援的結構描述驗證並合併這些物件。與多人遊戲設定相關聯的主要 JSON 物件如下：

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

與遊戲特別相關的 JSON 物件如下：

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

## 控制代碼

僅限 2015 多人遊戲，可以透過工作階段控制代碼存取工作階段。已新增數個 URI 以提供支援控制代碼的功能。

## 本節內容

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

  支援 POST 作業，以設定使用者目前活動的工作階段，使其顯示在 XBOX One 儀表板使用者體驗中，並在需要時邀請工作階段成員。

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

  支援針對以識別碼指定之工作階段控制代碼的 DELETE 和 GET 作業。

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

  使用控制代碼取值，支援工作階段的 PUT 和 GET 作業。

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

  支援 POST 作業，以建立工作階段控制代碼的查詢。

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

  支援在服務設定識別碼層級進行批次查詢的 POST 作業。

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

  支援 GET 作業，以擷取一組工作階段文件。

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

  支援 GET 作業，以擷取一組 MPSD 工作階段範本。

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

  支援 GET 作業，以擷取一組工作階段範本名稱。

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

  支援 POST 作業，以在工作階段範本層級建立批次查詢。

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

  支援 GET 作業，以擷取一組具有指定範本名稱的工作階段範本。

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

  支援 PUT 和 GET 作業，以建立和擷取工作階段。

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

  支援 DELETE 作業，以移除工作階段成員。

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

  支援 DELETE 作業，以移除工作階段的指定伺服器。

## 另請參閱

[配對 URI](https://docs.xbox.com/zh-TW/reference/live/rest/uri/matchtickets/atoc-reference-matchtickets.md)

##### 上層

[統一資源識別碼 (URI) 參考](https://docs.xbox.com/zh-TW/reference/live/rest/uri/atoc-xboxlivews-reference-uris.md)


## Related topics

- [多人遊戲工作階段目錄概觀](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [配對 URI](https://docs.xbox.com/zh-TW/reference/live/rest/uri/matchtickets/atoc-reference-matchtickets.md)
- [/handles](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-handles.md)
- [/serviceconfigs/{scid}/batch](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch.md)
- [/serviceconfigs/{scid}/sessions](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessions.md)