웹 요청 개요
이 주제에서는 Microsoft GDK(게임 개발 키트) 타이틀에 대한 HTTP(Hypertext Transfer Protocol) 및 WebSocket 웹 요청에 대한 개요를 제공합니다.
올바른 API 세트로 시작하면 Xbox 요구 사항(XR)을 준수하는 보안 통신을 더 쉽게 구현할 수 있습니다.
Xbox 콘솔 및 Windows 10 PC
보안 요구 사항을 준수하려면 다음 API를 사용하는 것이 좋습니다. 또한 웹 요청 구현을 단순화하는 데 도움이 됩니다.
| 사용 사례 | 권장 API |
|---|---|
| GRTS(게임 런타임 서비스) 스타일 API를 사용한 REST 요청 | Microsoft Xbox Live 서비스 API(XSAPI) |
| 범용 HTTP 요청 | x컬 |
| WebSocket 요청 | libHttpClient |
Windows HTTP 서비스(WinHTTP)
WinHTTP는 또한 코드 변경 없이 PC와 Xbox 콘솔 모두에서 HTTP 및 WebSocket 서비스 끝점을 만드는 데 사용할 수 있습니다. 이 API는 모든 보안 모범 사례를 자동으로 처리하지 않으므로 통신 보안 개요(NDA 항목)권한 부여 필요 및 WinHTTP 개요를 읽어 구현이 안전하고 강력한지 확인하는 방법을 알아보세요.
xCurl의 장점은 내부적으로 인증서 체인 유효성 검사 및 네트워킹 연결 검사를 포함하는 보안 모범 사례를 처리한다는 것입니다. 이것이 범용 HTTP 요청에 xCurl을 권장하는 이유입니다.
참고:
- Xbox 콘솔용 타이틀을 개발할 때 WinHTTP 또는 xCurl을 사용해야 합니다. 사용자 지정 HTTP 스택 구현은 허용되지 않습니다. 자세한 내용은 Xbox 콘솔 게임에 대한 Xbox 요구 사항에서 보안 아래의 XR-134: 웹 프로토콜을 사용하여 데이터 전송을 참조하세요.
- PC용 타이틀을 개발할 때 더 많은 옵션이 있습니다. 범용 HTTP 요청의 경우 libCurl 또는 다른 HTTP 스택을 Microsoft GDK(게임 개발 키트) 타이틀과 함께 직접 사용할 수도 있습니다.
x컬
xCurl은 Microsoft GDK(게임 개발 키트) 타이틀의 HTTP 요청에 권장되는 API입니다. 모든 보안 모범 사례를 자동으로 준수하여 타이틀 개발을 간소화합니다. API 표면은 libCurl과 광범위하게 일치하므로 libCurl의 완전한 유연성과 HTTP 기능 세트도 갖추고 있습니다.
xCurl API 및 xCurl과 libCurl의 차이점에 대해 자세히 알아보려면 xCurl 개요를 참조하세요.
XSAPI
XSAPI(Xbox Services API)는 Microsoft GDK(게임 개발 키트) 타이틀을 완벽하게 준수하는 일반 REST 래퍼를 제공합니다. 이 래퍼는 사용하기 쉽고 Microsoft GDK(게임 개발 키트) 비동기 API 모델을 따릅니다. 타이틀이 REST HTTP 요청만 수행해야 하는 경우 사용하기에 가장 간단한 완전 호환 인터페이스일 수 있습니다.
- XblHttpCallCreate를 사용하여,
REST요청을 추적하는 HTTP 핸들을 만듭니다. XblHttpCallRequestSet*함수 중 하나로 본문과 모든 추가 구성을 채우세요.- XblHttpCallPerformAsync를 호출하여 요청합니다.
- 응답을 검색하려면
XblHttpCallGet*함수 중 하나를 사용하세요. - XblHttpCallCloseHandle을 사용하여 핸들을 닫습니다.
참고 항목
XblHttpCallRequestSet* 및 XblHttpCallGet*은(는) HTTP 요청을 빌드하고 HTTP 응답을 검색하는 함수 그룹을 나타냅니다.
libHttpClient
libHttpClient는 양방향 통신이 가능하도록 설계되었습니다. HTTP 및 WebSocket 서비스 끝점을 활성화하기 위해 XSAPI(Xbox Live Service API)에서 사용하도록 설계된 추상화 계층입니다. API는 XSAPI의 일부로 GDK(게임 개발 키트)에 있습니다.