GET (/serviceconfigs//hoppers//stats)

호퍼에 대한 통계를 가져옵니다.

중요:
이 메서드는 contract 103 이상에서 사용하도록 되어 있으며, 모든 요청에서 X-Xbl-Contract-Version: 103 이상의 헤더 요소가 필요합니다.

설명
URI 매개 변수
권한 부여
HTTP 상태 코드
요청 본문
응답 본문

설명

이 HTTP/REST 메서드는 서비스 구성 ID(SCID) 수준에서 지정된 이름의 호퍼로부터 통계를 가져옵니다. 이 메서드는 Microsoft.Xbox.Services.Matchmaking.MatchmakingService.GetHopperStatisticsAsync API로 래핑할 수 있습니다.

URI 매개 변수

| 매개 변수| 형식| 설명| | --- | --- | --- | --- | | scid| GUID| 세션에 대한 서비스 구성 식별자(SCID)입니다.| | name| string| 호퍼의 이름입니다.|

권한 부여

| 형식| 필수| 설명| 누락 시 응답| | --- | --- | --- | --- | --- | --- | --- | --- | | XUID (user ID)| 예| 요청을 하는 사용자는 티켓이 참조하는 티켓 세션의 구성원이어야 합니다. | 403| | Privileges and Device Type| 예| 사용자의 deviceType이 console로 설정된 경우, 클레임에 multiplayer 권한이 있는 사용자만 매치메이킹 서비스에 대한 호출을 수행할 수 있습니다. | 403| | Title ID/Proof of Purchase/Device Type| 예| 매칭 대상 타이틀은 지정된 title claim, device type 조합에 대해 매치메이킹을 허용해야 합니다. | 403|

HTTP 상태 코드

서비스는 MPSD에 적용되는 HTTP 상태 코드를 반환합니다.

요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

응답 본문

| 멤버| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | hopperName| string| 선택된 호퍼의 이름입니다.| | waitTime| 32-bit signed integer| 호퍼에 대한 평균 매칭 시간(정수 초 단위)입니다. | | population| 32-bit signed integer| 호퍼에서 매치를 기다리고 있는 사람의 수입니다.|

샘플 응답

{
      "hopperName":"contosoawesome2",
      "waitTime":30,
      "population":1
    }

참고 항목

상위

/serviceconfigs//hoppers//stats

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

GET (/serviceconfigs/{scid}/hoppers/{name}/stats)

GET (/serviceconfigs//hoppers//stats)

설명

URI 매개 변수

권한 부여

HTTP 상태 코드

요청 본문

응답 본문

샘플 응답

참고 항목

상위

​GET (/serviceconfigs//hoppers//stats)

​설명

​URI 매개 변수

​권한 부여

​HTTP 상태 코드

​요청 본문

​응답 본문

​샘플 응답

​참고 항목

상위

GET (/serviceconfigs//hoppers//stats)

설명

URI 매개 변수

권한 부여

HTTP 상태 코드

요청 본문

응답 본문

샘플 응답

참고 항목