# 런처 실행코드 조회 API
# 소개
웹에서 런처 2.0 / 3.0 or SGA 3.0을 실행 할 수 있는 프로토콜 핸들러코드를 전달합니다.
WEB Aceess Token이 전달될 경우 로그인한 상태로 런처가 실행될 수 있는 코드를 전달합니다.
# 기본정보
GET /game/v2.0/launcher/{game_id}
Host:
https://api.gate8.com (SANDBOX)
https://api.onstove.com (Live)
Content-Type: application/json
1
2
3
4
5
2
3
4
5
# Request
# Header
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| Authorization | String | N | Bearer {Access Token} | bearer {token} | 플랫폼의 API를 사용하기 위한 Web Access Token |
| caller-id | String | Y | - | {game_id}_HOME | API 호출자 정보 -{game_id}_HOME(공홈) -{game_id}_SERVER(서버) |
# Path Variable
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| game_id | string | Y | STOVE_GAMEID | 게임아이디 |
# Parameter
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| inflow_path | String | N | STOVE_GAMEID | 호출 진입장소 : SGS 기술PM에게 문의 | |
| check_terms | String | N | Y | N | 약관체크 여부 : Y/N |
# Response
# Body
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| code | Integer | Y | - | 0 | 응답 코드 |
| message | String | Y | - | OK | 응답 메시지 |
| value | Object | N | - | {"code":0,"message":"OK","value":{}} | 응답 값 |
# Sample
# Request
- 비로그인 호출
curl --location 'https://api.gate8.com/game/v2.0/launcher/STOVE_GAMEID?inflow_path=STOVE_GAMEID&check_terms=N'
1
- 로그인 호출
curl --location 'https://api.gate8.com/game/v2.0/launcher/STOVE_GAMEID?inflow_path=STOVE_GAMEID&check_terms=N' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHBpcmVfdGltZSI6MTY5MzQxNTA4NTAxMiwibWVtYmVyX25vIjoxMDgxMzk0MzgsImFwcGxpY2F0aW9uX25vIjoxMDAwMn0.NDEGosALSxx4RXWTBhtEQesKWq_4Q4nTu86MWATl_-GL4nNVrNIA7UnnAi6KP5LPsMduzUPA4F60iu_oCQ64kgNonrmkt1vgXFgeag4UEbPy8hIjP6X_MbWIpOyGQSI64X9bRENsdNQgMJCQ6AyRiYRioy85xSazWzYPQ3BhuQaFq_bL9ryPNZt_Dq9J6xApSmv7ZigPhkHO2ZremTtjtecu6HSNCFwqHsCrwWq3UhyIDg4i6OvV_ughwOeuxfCuZhJF1SbAKrb_tVQVgyo1C_CwewcVRKpt4slvLvQtJ4k'
1
2
2
# Response
- 비로그인 호출(런처 타입 : SGA)
{
"code": 0,
"message": "OK",
"value": "sgagate8://run/STOVE_GAMEID"
}
1
2
3
4
5
2
3
4
5
- 로그인 호출(런처 타입 : SGA)
{
"code": 0,
"message": "OK",
"value": "sgagate8://run/STOVE_GAMEID?member_no=108139438&auth_code=5e4da05fc115a37d48b18ee00651668dbc0e9228601b91eb69c8425fd3110572e9dcb6c8fd90f04f0ac0f1a563f91c6194bdc66ad7dcff46c656c6dc7be83339"
}
1
2
3
4
5
2
3
4
5
- 비로그인 호출(런처 타입 : 런처 2.0/3.0)
{
"code": 0,
"message": "OK",
"value": "sgupgate8://run/STOVE_GAMEID"
}
1
2
3
4
5
2
3
4
5
- 로그인 호출(런처 타입 : 런처 2.0/3.0)
{
"code": 0,
"message": "OK",
"value": "sgupgate8://run/STOVE_GAMEID?member_no=108139438&auth_code=5e4da05fc115a37d48b18ee00651668dbc0e9228601b91eb69c8425fd3110572e9dcb6c8fd90f04f0ac0f1a563f91c6194bdc66ad7dcff46c656c6dc7be83339"
}
1
2
3
4
5
2
3
4
5
# Return Code
| HTTP Status code | response_code | response_message | Description |
|---|---|---|---|
| 200 | 0 | OK | 성공 |
| 200 | 701 | 게임을 찾을 수 없습니다. | 존재하지 않는 game_id 를 보냈을 경우 발생합니다. |
| 200 | 800 | Invalid Requested. Only Supported GUID Game | GUID 지원게임이 아닐 때 발생합니다. |