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

# XBOX services API の概要

> クライアントサイドの XBOX Services API (XSAPI) と XBOX Live REST エンドポイントを比較し、トレードオフを検討して、GDK タイトルに適したアプローチを選択します。

XBOX services から情報を取得する方法は 2 つあります。

1. **XBOX services API** (XSAPI) と呼ばれるクライアントサイド API を使用します。XBOX Live API とも呼ばれます。
2. **XBOX services REST エンドポイント**を直接呼び出します。これは XBOX Live REST エンドポイントとも呼ばれます。

## XSAPI を使用するメリット

XBOX services API (XSAPI) を使用するメリットは次のとおりです:

* 認証、エンコーディング、HTTP の送受信の詳細は自動的に処理されます。
* ラッパー API の引数および返されるデータはネイティブデータ型として扱われます。JSON のエンコード / デコードを行う必要はありません。
* Web サービスを直接呼び出す場合は複数の非同期ステップが必要ですが、ラッパー API はこれをカプセル化します。これによりタイトルのコードが読み書きしやすくなります。
* ゲームイベントの書き込みなど、一部の機能は XSAPI でしか利用できません。

## XBOX services REST エンドポイントを使用するメリット

XBOX services REST エンドポイントを直接使用するメリットは次のとおりです:

* Web サービスから XBOX services エンドポイントを呼び出せます。
* XSAPI に含まれていないエンドポイントを呼び出せます。XSAPI にはゲームで使用されると想定される API のみが含まれています。不足しているものがあれば、フォーラムからご連絡ください。
* REST エンドポイント経由で利用できる機能の中には、対応する XSAPI ラッパーがないものもあります。

ゲームやアプリはこれらの方法のいずれか 1 つだけを使用しなければならないという制約はありません。XSAPI ラッパーを使用しつつ、必要に応じて REST エンドポイントを直接呼び出すこともできます。詳細については、[XBOX services REST API リファレンス](https://docs.xbox.com/ja-jp/reference/live/rest/atoc-xboxlivews-reference.md)を参照してください。

## クライアントサイド 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 専用)

### XSAPI C ベース API

* PC および XBOX コンソール GDK タイトルをサポートします。
* XSAPI 呼び出し時のメモリ割り当てをタイトルで制御できます。
* XSAPI 呼び出し時のスレッド処理をタイトルで完全に制御できます。
* ゲーム開発者向けに設計された新しい HTTP ライブラリ [libHttpClient](https://docs.xbox.com/ja-jp/reference/live/httpclient/atoc-httpclient.md) を使用します。

詳細については、[XBOX Live C API の概要](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/xbox-services-api/live-xsapi-flat-c.md)を参照してください。

API リファレンスについては、[XSAPI C リファレンス](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/atoc-xsapi-c.md)を参照してください。

## 関連項目

[XSAPI C API の概要](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/xbox-services-api/live-xsapi-flat-c.md)
[XSAPI リファレンス](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/atoc-xsapi-c.md)
[REST API リファレンス](https://docs.xbox.com/ja-jp/reference/live/rest/atoc-xboxlivews-reference.md)
[libHttpClient](https://docs.xbox.com/ja-jp/reference/live/httpclient/atoc-httpclient.md)


## Related topics

- [概要](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/live-xbl-overview.md)
- [XBOX Achievements Manager API の概要](https://docs.xbox.com/ja-jp/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XBOX Series X|S の概要](https://docs.xbox.com/ja-jp/paths/series-xs/overview.md)
- [Multiplayer Manager API の概要](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XBOX services API リファレンス](https://docs.xbox.com/ja-jp/reference/live/gc-reference-live-toc.md)