그룹 매치 API

게임 플레이 시, 지인 혹은 친구 등 그룹 단위로 매칭을 적용할 때 사용하는 API 입니다.

매칭 요청 전에, 2명 이상의 앱 사용자가 그룹 을 생성 후, 그룹 대표가 매칭 요청을 진행합니다.

Note

그룹 API 는 매치 ID 설정 중 매치 단위 / 인원 이 팀 인 경우에만 사용할 수 있습니다.

그룹 생성¶

같은 팀이 될 멤버를 초대하는 그룹을 생성하는 API 입니다.

생성 요청자는 그룹장(방장)이 됩니다.
개인 매칭 요청 중에는 사용할 수 없습니다.
생성 시 지인을 초대하기 위한 입장용 코드가 함께 제공됩니다.
생성 시 해당 매치 ID의 룰에 대응하기 위한 점수 정보를 같이 입력 할 수 있습니다.

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group
HTTP METHOD	POST
CONTENT-TYPE	application/json

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y
matchId	Hive 콘솔에서 생성한 각 매치 식별자	int	Y

Request body¶

필드명	설명	타입	필수 여부
playerId	계정 식별자	long	Y
point	매칭에 사용할 점수입니다. 입력 범위는 `0 ~ 999,999,999`입니다. 미입력 시 `0`으로 처리합니다.	integer	N
extraData	계정 부가 정보(닉네임, 레벨, 국가 등)입니다. 최대 256자까지 입력 가능합니다. 매칭 결과에 같이 포함됩니다.	string	N

Response¶

필드명	설명	타입
groupCode	해당 그룹에 입장을 하기 위한 코드	string
ownerPlayerId	그룹장(방장)의 계정 식별자	long
memberInfos	결과 메시지	object
matchInfo	그룹이 속한 `gameIndex` 및 `matchId` 정보	object
requstingStatus	요청 상태 정보	string

Request sample¶

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/group' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"playerId":1}'

Response sample¶

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfos": [
        {
            "playerId": 1
        }
    ],
    "requestingStatus": "notRequested"
}

그룹 참여¶

그룹에 참여를 희망하는 앱 사용자가 그룹장(방장)으로부터 받은 코드(groupCode)를 이용하여 그룹에 참여할 때 사용하는 API입니다.

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/groups/code/{code}/member
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/groups/code/{code}/member
HTTP METHOD	POST

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y
matchId	Hive 콘솔에서 생성한 각 매치 식별자	int	Y
code	그룹 생성 API 의 Response 로 받은 `groupCode` 값	string	Y

Request body¶

필드명	설명	타입	필수 여부
playerId	계정 식별자	long	Y
point	매칭에 사용할 점수입니다. 입력 범위는 `0 ~ 999,999,999`입니다. 미입력 시 `0`으로 처리합니다.	integer	N
extraData	계정 부가 정보(닉네임, 레벨, 국가 등)입니다. 최대 256자까지 입력 가능합니다. 매칭 결과에 같이 포함됩니다.	string	N

Response¶

필드명	설명	타입
groupCode	해당 그룹에 입장을 하기 위한 코드	string
ownerPlayerId	그룹장(방장)의 계정 식별자	long
memberInfos	결과 메시지	object
matchInfo	그룹이 속한 `gameIndex` 및 `matchId` 정보	object
requestingStatus	요청 상태 정보	string

Request sample¶

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/groups/code/0343322/member' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"playerId":2}'

Response sample¶

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        },
        {
            "playerId": 2
        }
    ],
    "requestingStatus": "notRequested"
}

그룹 탈퇴¶

현재 속한 그룹에서 퇴장하고 싶을 때 사용하는 API 입니다. 그룹장(방장)이 나가는 경우에는 남은 구성원중에 한명이 다음 그룹장이 됩니다.

남은 구성원이 없는 경우, 해당 그룹은 제거 됩니다.

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group
HTTP METHOD	DELETE

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y
matchId	Hive 콘솔에서 생성한 각 매치 식별자	int	Y
playerId	사용자 ID	long	Y

Response¶

200 OK인 경우, Body는 비어있습니다.

Request sample¶

curl --location --request DELETE 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/players/2/group' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a'

Response sample¶

정상 처리 시 특별한 응답 내용은 없습니다.

그룹 강제 퇴장(강퇴)¶

그룹장(방장)이 특정 구성원을 강제로 내보낼 수 있는 API 입니다.

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group/members/{targetPlayerId}
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group/members/{targetPlayerId}
HTTP METHOD	DELETE

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y
matchId	Hive 콘솔에서 생성한 각 매치 식별자	int	Y
playerId	사용자 ID	long	Y
targetPlayerId	강제 퇴장시킬 구성원의 ID	long	Y

Response¶

그룹 생성 API 의 결과 데이터와 같은 형식입니다. 멤버들의 정보(memberInfos)에서 강제로 퇴장 시킨 구성원 정보만 제거됩니다.

필드명	설명	타입
groupCode	해당 그룹에 입장을 하기 위한 코드	string
ownerPlayerId	그룹장(방장)의 계정 식별자	long
memberInfos	결과 메시지	object
matchInfo	그룹이 속한 `gameIndex` 및 `matchId` 정보	object
requstingStatus	요청 상태 정보	string

Request sample¶

curl --location --request DELETE 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/players/1/group/members/2' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a'

Response sample¶

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        }
    ],
    "requestingStatus": "notRequested"
}

그룹 정보 조회 (그룹 내 멤버 기준)¶

요청 시점에 앱 사용자가 속한 그룹의 정보를 조회하는 API 입니다. 여러가지 목적으로 사용할 수 있으며, Polling 을 통해 주기적으로 조회하는 것이 필요합니다.

보통 다음의 목적으로 사용합니다.

그룹에 참여한 앱 사용자들의 목록 확인
매칭 요청 후, 매칭 결과 확인

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group
HTTP METHOD	GET

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y
matchId	Hive 콘솔에서 생성한 각 매치 식별자	int	Y
playerId	사용자 ID	long	Y

Response¶

필드명	설명	타입
groupCode	해당 그룹에 입장을 하기 위한 코드	string
ownerPlayerId	그룹장(방장)의 계정 식별자	long
memberInfos	결과 메시지	object
matchInfo	그룹이 속한 `gameIndex` 및 `matchId` 정보	object
requstingStatus	요청 상태 정보	string
requestingInfo	매칭 요청 정보	object
matchingInfo	매칭 진행 정보	object

Request sample¶

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/players/1/group' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a'

Response sample¶

// 매칭 요청 전
{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        }
    ],
    "requestingStatus": "notRequested"
}
// 매칭이 성사된 이후 (2:2 팀전)
{
    "groupCode": "3683207",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1,
            "ready": true
        },
        {
            "playerId": 2,
            "ready": true
        }
    ],
    "matchingInfo": {
        "status": "matched",
        "matchingId": "2:1_2024-12-18T06:55:19.91_1",
        "teamInfos": [
            {
                "teamIndex": 0,
                "playerInfos": [
                    {
                        "playerId": 4,
                        "point": 50,
                        "extraData": "bbb"
                    },
                    {
                        "playerId": 3,
                        "extraData": "aaa"
                    }
                ]
            },
            {
                "teamIndex": 1,
                "playerInfos": [
                    {
                        "playerId": 1,
                        "extraData": "extra1"
                    },
                    {
                        "playerId": 2,
                        "point": 250,
                        "extraData": "aaa"
                    }
                ]
            }
        ]
    },
    "requestingStatus": "requested",
    "requestingInfo": {
        "requestTimeUtc": "2024-12-18T06:55:19.17"
    }
}
// 매칭 시간이 초과된 경우(timeout)
{
    "groupCode": "0400606",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1,
            "ready": true
        },
        {
            "playerId": 2,
            "ready": true
        }
    ],
    "matchingInfo": {
        "status": "timeout"
    },
    "requestingStatus": "requested",
    "requestingInfo": {
        "requestTimeUtc": "2024-12-20T06:37:47.99"
    }
}

그룹 정보 조회 (코드 기준)¶

그룹장(방장)으로부터 제공 받은 코드(groupCode)를 사용하여, 해당 그룹이 존재하는지 확인하는 API 입니다.

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/groups
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/groups
HTTP METHOD	GET

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y

Query parameters¶

필드명	설명	타입	필수 여부
code	그룹 코드 (`groupCode)`	string	Y

Response¶

필드명	설명	타입
groupCode	해당 그룹에 입장을 하기 위한 코드	string
ownerPlayerId	그룹장(방장)의 계정 식별자	long
matchInfo	그룹이 속한 `gameIndex` 및 `matchId` 정보	object

Request sample¶

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/groups?code=0343322' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a'

Response sample¶

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1
}

멤버 정보 수정¶

그룹에 속한 구성원이 자신의 정보를 변경할 때 사용하는 API 입니다. 변경 가능한 정보는 아래와 같습니다.

준비 상태(ready) - 그룹장(방장)은 사용하지 않는 항목입니다.
점수(point)
부가 정보(extraData)

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group/memberinfo
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group/memberinfo
HTTP METHOD	PATCH
CONTENT-TYPE	application/json

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y
matchId	Hive 콘솔에서 생성한 각 매치 식별자	int	Y
playerId	사용자 ID	long	Y

Request body¶

필드명	설명	타입	필수 여부
ready	준비 상태	boolean	Y
point	매칭에 사용할 점수입니다. 입력 범위는 `0 ~ 999,999,999`입니다. 미입력 시 `0`으로 처리합니다.	integer	N
extraData	계정 부가 정보(닉네임, 레벨, 국가 등)입니다. 최대 256자까지 입력 가능합니다. 매칭 결과에 같이 포함됩니다.	string	N

Response¶

필드명	설명	타입
groupCode	해당 그룹에 입장을 하기 위한 코드	string
ownerPlayerId	그룹장(방장)의 계정 식별자	long
memberInfos	결과 메시지	object
matchInfo	그룹이 속한 `gameIndex` 및 `matchId` 정보	object
requstingStatus	요청 상태 정보	string

Request sample¶

curl --location --request PATCH 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/players/2/group/memberinfo' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"ready":false,"point":0,"extraData":""}'

Response sample¶

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        }
    ],
    "requestingStatus": "notRequested"
}

매칭 요청¶

매칭을 시작하기 위해 각 그룹별로 요청하는 API 입니다.

matchId에 해당되는 매치를 사전에 콘솔에서 생성해야 합니다. (개인 매칭 요청과 동일)
요청 시점에 멤버가 2명 이상 있어야 합니다.
그룹장(방장) 이 아닌 멤버는 '준비 상태'(Ready)가 true여야 합니다.
기존에 진행한 매칭이 있을 경우, 정리(삭제) 후 요청해야 합니다.
그룹 대표(방장)만 요청할 수 있습니다.

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group/request
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group/request
HTTP METHOD	POST
CONTENT-TYPE	application/json

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y
matchId	Hive 콘솔에서 생성한 각 매치 식별자	int	Y

Request body¶

필드명	설명	타입	필수 여부
playerId	계정 식별자	long	Y

Response¶

필드명	설명	타입
groupCode	해당 그룹에 입장을 하기 위한 코드	string
ownerPlayerId	그룹장(방장)의 계정 식별자	long
memberInfos	결과 메시지	object
matchInfo	그룹이 속한 `gameIndex` 및 `matchId` 정보	object
requstingStatus	요청 상태 정보	string
requestingInfo	매칭 요청 정보	object
matchingInfo	매칭 진행 정보	object

Request sample¶

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/group/request' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"playerId":1}'

Response sample¶

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        },
        {
            "playerId": 2,
            "ready": true
        }
    ],
    "matchingInfo": {
        "status": "matchingInProgress"
    },
    "requestingStatus": "requested",
    "requestingInfo": {
        "requestTimeUtc": "2024-12-05T07:35:35.15"
    }
}

매칭 요청 취소¶

Request URL¶

LIVE URL	https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group/request
SANDBOX URL	https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group/request
HTTP METHOD	DELETE

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API 호출을 위한 인증 토큰 (Bearer)	string	Y

Path parameters¶

필드명	설명	타입	필수 여부
gameIndex	Hive 콘솔 앱센터에서 확인 가능한 프로젝트 식별자	int	Y
matchId	Hive 콘솔에서 생성한 각 매치 식별자	int	Y

Request body¶

필드명	설명	타입	필수 여부
playerId	계정 식별자	long	Y

Response¶

필드명	설명	타입
groupCode	해당 그룹에 입장을 하기 위한 코드	string
ownerPlayerId	그룹장(방장)의 계정 식별자	long
memberInfos	결과 메시지	object
matchInfo	그룹이 속한 `gameIndex` 및 `matchId` 정보	object
requstingStatus	요청 상태 정보	string

Request sample¶

curl --location --request DELETE 'https://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/group/request' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"playerId":3}'

Response sample¶

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        },
        {
            "playerId": 2
        }
    ],
    "requestingStatus": "notRequested"
}

공용 응답¶

그룹 관련 API 응답 중 공통으로 사용하는 필드에 관한 설명입니다.

memberInfos¶

그룹에 속한 멤버(그룹장 혹은 방장 포함) 정보로 구성되는 필드는 아래와 같습니다.

필드명	설명	타입
playerId	계정 식별자	long
ready	준비 상태	boolean
point	그룹 참여(갱신)시 입력한 점수	integer
extraData	그룹 참여(갱신)시 입력한 부가 정보	string

matchInfo¶

그룹이 속한 gameIndex 및 matchId 정보로 구성되는 필드는 아래와 같습니다.

필드명	설명	타입
gameIndex	콘솔의 `앱센터` 에서 등록한 프로젝트의 `Game Index` 값	integer
matchId	콘솔의 `매치 메이킹` 에서 등록한 `매치 ID`	integer

requestingStatus¶

매칭 요청 상태 필드로 해당되는 값은 아래와 같습니다.

notRequested: 매칭을 요청 하지 않음
requested: 매칭을 요청함

requestingInfo¶

매칭 요청 정보 필드입니다.

필드명	설명	타입
requestTimeUtc	UTC+0 기준, 요청 시간	string

matchingInfo¶

매칭 진행 정보로 구성되는 필드는 아래와 같습니다.

필드명	설명	타입
status	매칭 진행 상태	string
matchingId	성사된 매칭에 부여하는 Id. 위 status 가 `matched` 일 때 추가됩니다.	string
privateInfos	(개인전 일 때) 매칭된 앱 사용자들의 정보를 배열로 출력합니다.	array
teamInfos	(팀전 일 때) 매칭된 앱 사용자들의 정보를 배열로 출력합니다.	array

matchingInfo → status¶

매칭 진행 정보 중 상태 필드에 해당하는 값은 아래와 같습니다.

matchingInProgress : 매칭 진행 중
timeout : 제한 시간 내 매칭이 이루어지지 않음
matched : 매칭이 성사됨

matchingInfo → privateInfos¶

매칭 진행 정보 중 개인 매칭된 앱 사용자 정보를 구성하는 필드는 아래와 같습니다. matchingInfo → teamInfos → playerInfos와 동일한 데이터 형식입니다.

필드명	설명	타입
playerId	계정 식별자. 0 일 경우 bot 으로 처리 필요	long
point	그룹 참여(갱신)시 입력한 점수	integer
extraData	그룹 참여(갱신)시 입력한 부가 정보	string

matchingInfo → teamInfos¶

매칭 진행 정보 중 그룹 매칭된 팀 정보를 구성하는 필드는 아래와 같습니다.

필드명	설명	타입
teamIndex	팀 구별을 위한 값. 0 부터 시작	integer
playerInfos	팀에 소속된 앱 사용자의 정보	array

matchingInfo → teamInfos → playerInfos¶

매칭 진행 정보 중 그룹 매칭된 팀의 앱 사용자 정보를 구성하는 필드는 아래와 같습니다. matchingInfo → privateInfos 와 동일한 데이터 형식입니다.

필드명	설명	타입
playerId	계정 식별자. 0 일 경우 bot 으로 처리 필요	long
point	그룹 참여(갱신)시 입력한 점수	integer
extraData	그룹 참여(갱신)시 입력한 부가 정보	string