# 게임 캐시 잔액 조회 API
# 소개
실캐시, 보너스캐시, 선물 불가 캐시 등의 잔액 정보를 불러옵니다.
# 기본정보
GET /bill/v2.0/cash/{game_code}/balance
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 | Y | Bearer {user_access_token} | User Access Token |
# Path Variable
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| game_code | string(40) | Y | - | STOVE_GAME | game_id 값과 동일 (플랫폼에서 부여) |
# Response
# Body
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| result | string(3) | Y | 000 | 결과 코드 값. 000 일경우 성공, 그외 오류. | |
| message | string(256) | Y | OK | 응답 메시지 | |
| value | json array | N | 응답 값 |
# value
| Name | Type | Required | Default Value | Example | Description |
|---|---|---|---|---|---|
| cashamt | decimal number | N | - | - | 실캐시+보너스캐시수 |
| cash_real | decimal number | N | - | - | 실캐시 잔액 |
| cash_bonus | decimal number | N | - | - | 보너스캐시 잔액 |
| no_present_cash | decimal number | N | - | - | 선물 불가캐시 |
# Sample
# Request
GET /bill/v2.0/cash/{game_code}/balance
HTTP/1.1
Host: api.onstove.com
Connection: keep-alive
1
2
3
4
2
3
4
# Response
응답성공
{
"value": {
"cashamt": 5000,
"cash_real":2500,
"cash_bonus":1500,
"no_present_cash":1000
},
"result": "000",
"message": "OK"
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
응답실패
{
"result":"999",
"message":"Authorization has been denied for this request"
}
1
2
3
4
2
3
4
# Return Code
| HTTP Status code | Code | Message | Description |
|---|---|---|---|
| 200 | 000 | OK | 성공 |
| 200 | 999 | unexpected error | - |
| 401 | 999 | Authorization has been denied for this request | - |
| 406 | 2001 | 실 게임 캐시 잔액이 원장과 일치하지 않습니다. | - |
| 406 | 2002 | 보너스 게임 캐시 잔액이 원장과 일치하지 않습니다. | - |
| 406 | 2003 | 실 게임 캐시 잔액이 0보다 작습니다. | - |
| 406 | 2004 | 보너스 게임 캐시 잔액이 0보다 작습니다. | - |
| 406 | 2005 | DB 예외 에러 | - |
| 200 | 2000번대 ~ 3000번대 | [Internal Error] | 내부오류: SGS 기술PM에 문의 부탁드립니다. |