> ## 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 services API 개요

> 클라이언트 측 XBOX Services API(XSAPI)와 XBOX Live REST 엔드포인트를 비교하고, 장단점을 저울질하며, GDK 타이틀에 적합한 접근 방식을 선택합니다.

XBOX 서비스에서 정보를 가져오는 방법에는 두 가지가 있습니다.

1. **XBOX services API** 또는 XSAPI라는 클라이언트 측 API를 사용합니다. XBOX Live API라고도 합니다.
2. **XBOX 서비스 REST 엔드포인트**를 직접 호출합니다. XBOX Live REST 엔드포인트라고도 합니다.

### XSAPI 사용의 이점

XBOX services API(XSAPI) 사용의 이점은 다음과 같습니다.

* 인증, 인코딩 및 HTTP 송수신에 대한 세부 사항이 자동으로 처리됩니다.
* 래퍼 API의 인수와 반환된 데이터는 네이티브 데이터 타입으로 처리됩니다. JSON 인코딩 및 디코딩을 수행할 필요가 없습니다.
* 웹 서비스를 직접 호출하는 것은 여러 비동기 단계를 포함하며, 래퍼 API가 이를 캡슐화합니다. 이로 인해 타이틀 코드를 더 쉽게 읽고 쓸 수 있습니다.
* 게임 이벤트 작성과 같은 일부 기능은 XSAPI에서만 사용할 수 있습니다.

### XBOX 서비스 REST 엔드포인트 사용의 이점

XBOX 서비스 REST 엔드포인트를 직접 사용하는 이점은 다음과 같습니다.

* 웹 서비스에서 XBOX 서비스 엔드포인트를 호출할 수 있습니다.
* XSAPI에 포함되지 않은 엔드포인트를 호출할 수 있습니다. XSAPI에는 게임이 사용할 것으로 예상되는 API만 포함되어 있습니다. 누락된 항목이 있는 경우 포럼을 통해 문의하세요.
* REST 엔드포인트를 통해 사용 가능한 일부 기능에는 해당하는 XSAPI 래퍼가 없을 수 있습니다.

게임과 앱은 이러한 방법 중 하나만 사용하도록 제한되지 않습니다. XSAPI 래퍼를 사용하면서 필요한 경우 REST 엔드포인트를 직접 호출할 수도 있습니다. 자세한 내용은 [XBOX 서비스 REST API 참조](/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 프로그램 전용)
* XSAPI C++11 기반 API (XDK 및 XBOX Creators 프로그램 전용)

### XSAPI C 기반 API

* 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 서비스 개요](/ko/services/xbox-services/fundamentals/live-xbl-overview.md)
- [XBOX Achievements Manager API 개요](/ko/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XBOX services 샌드박스 개요](/ko/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [개요](/ko/services/xbox-services/multiplayer/overviews/index.md)
- [XSAPI C 개요](/ko/services/xbox-services/fundamentals/xbox-services-api/live-xsapi-flat-c.md)