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

# XBOX 服務 API 概觀

> 比較用戶端 XBOX 服務 API (XSAPI) 和 XBOX Live REST 端點、權衡取捨，並為您的 GDK 遊戲選擇合適的方法。

從 XBOX 服務取得資訊有兩種方式。

1. 使用稱為 **XBOX 服務 API** 或 XSAPI 的用戶端 API。它也稱為 XBOX Live API。
2. 直接呼叫 **XBOX 服務 REST 端點**。它們也稱為 XBOX Live REST 端點。

### 使用 XSAPI 的優點

使用 XBOX 服務 API (XSAPI) 的優點包括：

* 驗證、編碼以及 HTTP 傳送和接收的詳細資料都會為您處理。
* 包裝函式 API 的引數和傳回的資料會以原生資料類型處理。您不需要執行 JSON 編碼和解碼。
* 直接呼叫 Web 服務涉及多個非同步步驟，而包裝函式 API 會將這些步驟封裝起來。這讓遊戲程式碼更容易閱讀和撰寫。
* 某些功能 (例如寫入遊戲事件) 只能在 XSAPI 中使用。

### 使用 XBOX 服務 REST 端點的優點

直接使用 XBOX 服務 REST 端點的優點包括：

* 能夠從 Web 服務呼叫 XBOX 服務端點。
* 能夠呼叫 XSAPI 中未包含的端點。它只包含我們認為遊戲會使用的 API。如果有任何遺漏，請透過論壇與我們連絡。
* 透過 REST 端點提供的某些功能可能沒有對應的 XSAPI 包裝函式。

您的遊戲和應用程式不限於只使用其中一種方法。您可以使用 XSAPI 包裝函式，並在需要時仍直接呼叫 REST 端點。如需詳細資訊，請參閱 [XBOX 服務 REST API 參考](/zh-TW/reference/live/rest/atoc-xboxlivews-reference)。

## 用戶端 API 集

XSAPI 公開支援各種客戶案例的用戶端 API。

**重要**：對於 GDK 開發，請只使用以 XSAPI C 為基礎的 API。此處包含的 XSAPI WinRT 和 C++11 API 僅供參考。

* [以 XSAPI C 為基礎的 API](#xsapi-c-based-api) (GDK)；自 2018 年 6 月起推出
* XSAPI WinRT API (僅限 XDK 和 XBOX Creators Program)
* 以 XSAPI C++11 為基礎的 API (僅限 XDK 和 XBOX Creators Program)

<a id="xsapi-c-based-api" />

### 以 XSAPI C 為基礎的 API

* 支援 PC 和 XBOX 主機 GDK 遊戲。
* 允許遊戲在呼叫 XSAPI 時控制記憶體配置。
* 允許遊戲在呼叫 XSAPI 時完全控制執行緒處理。
* 使用專為遊戲開發人員設計的新 HTTP 程式庫 [libHttpClient](/zh-TW/reference/live/httpclient/atoc-httpclient)。

若要深入了解，請參閱 [XBOX Live C API 簡介](/zh-TW/services/xbox-services/fundamentals/xbox-services-api/live-xsapi-flat-c)。

如需 API 參考，請參閱 [XSAPI C 參考](/zh-TW/reference/live/xsapi-c/atoc-xsapi-c)。

## 另請參閱

[XSAPI C API 簡介](/zh-TW/services/xbox-services/fundamentals/xbox-services-api/live-xsapi-flat-c)
[XSAPI 參考](/zh-TW/reference/live/xsapi-c/atoc-xsapi-c)
[REST API 參考](/zh-TW/reference/live/rest/atoc-xboxlivews-reference)
[libHttpClient](/zh-TW/reference/live/httpclient/atoc-httpclient)


## Related topics

- [XBOX 服務概觀](/zh-TW/services/xbox-services/fundamentals/live-xbl-overview.md)
- [XBOX 服務沙箱概觀](/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [XBOX 服務多人遊戲概觀](/zh-TW/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md)
- [XBOX 服務使用者權限概觀](/zh-TW/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview.md)
- [服務 C API 概觀 - PFInventory.h](/zh-TW/services/playfab/api-references/c/pfinventory/pfinventory_members.md)
