> ## 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 Services 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 参考](/reference/live/rest/atoc-xboxlivews-reference)。

## 客户端 API 集

XSAPI 公开了支持广泛客户方案的客户端 API。

**重要**：对于 GDK 开发，仅使用基于 C 的 XSAPI。XSAPI WinRT 和 C++11 API 仅供你参考。

* [基于 C 的 XSAPI](#xsapi-c-based-api) (GDK)；2018 年 6 月新增
* XSAPI WinRT API（仅限 XDK 和 XBOX Creators 计划）
* 基于 C++11 的 XSAPI（仅限 XDK 和 XBOX Creators 计划）

### 基于 C 的 XSAPI

* 支持 PC 和 XBOX 控制台 GDK 标题。
* 允许标题在调用 XSAPI 时控制内存分配。
* 允许标题在调用 XSAPI 时完全控制线程处理。
* 使用为游戏开发人员设计的新的 HTTP 库 [libHttpClient](/reference/live/httpclient/atoc-httpclient)。

要了解更多信息，请参阅 [XBOX Live C API 简介](/services/xbox-services/fundamentals/xbox-services-api/live-xsapi-flat-c)。

有关 API 参考，请参阅 [XSAPI C 参考](/reference/live/xsapi-c/atoc-xsapi-c)。

## 另请参阅

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


## Related topics

- [XBOX 服务 Title Storage 概述](/zh-CN/services/xbox-services/storage/title-storage/live-title-storage-overview.md)
- [XBOX 服务沙盒概述](/zh-CN/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [XBOX 服务 API 参考](/zh-CN/reference/live/gc-reference-live-toc.md)
- [社交功能概述](/zh-CN/services/xbox-services/community/live-social-overview.md)
- [访客用户概述](/zh-CN/build/core-features/common/user/users-guest-overview.md)