API 목록

GAME API 목록으로 돌아가기

야구 게임 정보

요청

Request

GET /game/baseball/game-info HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MjkiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU1LCJleHAiOjE3MTExMjI3NTV9.rRwY2B2RVDH2rkAHIed_mMeTMlUNqrZKKCaKFGAVCjU
Cookie: refreshToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MjkiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU1LCJleHAiOjE3MTIzMjg3NTV9.cwxtzHFRXr97-njwPcTc_GCoZyyhcxbhKWwF-jgYbr4

Request Cookies

Name Description

accessToken

ACCESS TOKEN

refreshToken

REFRESH TOKEN

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 125

{
  "guessNumberLength" : 4,
  "tryCount" : 9,
  "maxBettingPoint" : 5000,
  "minBettingPoint" : 1000,
  "maxPlayTime" : 10
}

Response Fields

Path Type Description

guessNumberLength

Number

추측할 숫자 길이

tryCount

Number

라운드 수

maxBettingPoint

Number

최대 베팅 포인트

minBettingPoint

Number

최소 베팅 포인트

maxPlayTime

Number

최대 플레이 가능 횟수

야구 게임 상태 가져오기

요청

Request

GET /game/baseball/status HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MzMiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU1LCJleHAiOjE3MTExMjI3NTV9.mch_mItHLkNRW9F8hS6aOQhNGbhYP0GLzNUMQ38L49M
Cookie: refreshToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MzMiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU1LCJleHAiOjE3MTIzMjg3NTV9.q0TVqXKgLHskO-a2Y1lGqgiQrerg19KTskb2KeYx94Q

Request Cookies

Name Description

accessToken

ACCESS TOKEN

refreshToken

REFRESH TOKEN

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 52

{
  "status" : "NOT_START",
  "baseballPerDay" : 0
}

Response Fields

Path Type Description

status

String

[NOT_START, PLAYING, END, 중 하나로 내려갑니다.]

baseballPerDay

Number

현재 야구게임 플레이 횟수 (시작을 안했으면 0, 했으면 1 이상)
NOT START: 오늘 한 번도 시작하지 않았으면 NOT_START가 반환됩니다.
PLAYING: start를 누른 뒤 게임이 끝나지 않았으면 PLAYING이 반환됩니다.
END: TRY COUNT를 모두 사용했거나 4strike로 맞춘적이 있는 경우 END가 반환됩니다.

야구 게임 START

이 API를 호출하면 게임 플레이 횟수가 차감되고 베팅 포인트만큼 member의 포인트가 차감됩니다. 게임 종료 후 베팅 포인트에 비례해서 포인트를 부여합니다.

요청

Request

POST /game/baseball/start HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 27
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MjciLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU0LCJleHAiOjE3MTExMjI3NTR9.B2iRm7wTm0EKvJRFCpybIIhNiYK_2EL-fna21koUFSc
Cookie: refreshToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MjciLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU0LCJleHAiOjE3MTIzMjg3NTR9.5bPMv8ICNMJ5mDOYFqpXsyq9DgSrexRS7t_Eg1TKyiM

{
  "bettingPoint" : 1000
}

Request Cookies

Name Description

accessToken

ACCESS TOKEN

refreshToken

REFRESH TOKEN

Request Fields

필드명 타입 필수값 양식 설명

bettingPoint

Number

true

베팅을 할 포인트 (1000이상 5000이하)

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 97

{
  "results" : [ ],
  "bettingPoint" : 1000,
  "earnablePoint" : 2000,
  "remainedSecond" : 30
}

야구 게임 GUESS

요청

Request

POST /game/baseball/guess HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 28
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MjQiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU0LCJleHAiOjE3MTExMjI3NTR9.JR0wwDDxDjm1_g_mgcCHO1dZXw9b2Nqu7Pb0OljF8kk
Cookie: refreshToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MjQiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU0LCJleHAiOjE3MTIzMjg3NTR9.lG2ZfPhoP5pDlbUMG6wMn1UMYAIaIvNLAHw6g1XOiOE

{
  "guessNumber" : "1234"
}

Request Cookies

Name Description

accessToken

ACCESS TOKEN

refreshToken

REFRESH TOKEN

Request Fields

필드명 타입 필수값 양식 설명

guessNumber

String

true

추측한 숫자 (반드시 4자 여야 합니다)

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 367

{
  "results" : [ {
    "guessNumber" : "1357",
    "strike" : 0,
    "ball" : 0
  }, {
    "guessNumber" : "2468",
    "strike" : 2,
    "ball" : 2
  }, {
    "guessNumber" : "7890",
    "strike" : 3,
    "ball" : 0
  }, {
    "guessNumber" : "1234",
    "strike" : 4,
    "ball" : 0
  } ],
  "bettingPoint" : 1000,
  "earnablePoint" : 1000,
  "remainedSecond" : 0
}

Response Fields

Path Type Description

results

Array

타임아웃난 round는 null

results[].guessNumber

String

해당 라운드에 사용자가 입력한 추측 숫자

results[].strike

Number

strike

results[].ball

Number

ball

earnablePoint

Number

획득한 포인트 (마지막 게임이 아니면 0)

bettingPoint

Number

게임 시작 베팅 포인트

remainedSecond

Number

이번 라운드 남은 초. 이 API에선 항상 0으로 반환됩니다.
타임아웃이 난 round가 있으면 아래와 같이 results 에 null이 들어갑니다. 
{
  "results" : [
        { "guessNumber" : "1234", "strike" : 0, "ball" : 0 },
        null,
        null,
        { "guessNumber" : "5678", "strike" : 4, "ball" : 0 }
  ],
  "earnablePoint" : 2000
}

야구 게임 결과 가져오기

요청

Request

GET /game/baseball/result HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MjUiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU0LCJleHAiOjE3MTExMjI3NTR9.REH_iICq5JdWRp4RCE8zLYLQrRRGIYhkVoyiA0PgsMk
Cookie: refreshToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MjUiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTU0LCJleHAiOjE3MTIzMjg3NTR9.ID5ShTlCumZRt7gjvkCJx95Jab3oryOBwxwA7_synDs

Request Cookies

Name Description

accessToken

ACCESS TOKEN

refreshToken

REFRESH TOKEN

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 318

{
  "results" : [ {
    "guessNumber" : "1234",
    "strike" : 2,
    "ball" : 2
  }, null, {
    "guessNumber" : "3456",
    "strike" : 1,
    "ball" : 0
  }, null, null, {
    "guessNumber" : "5678",
    "strike" : 3,
    "ball" : 0
  } ],
  "bettingPoint" : 1000,
  "earnablePoint" : 1000,
  "remainedSecond" : 29
}

Response Fields

Path Type Description

results

Array

타임아웃난 round는 null

earnablePoint

Number

획득한 포인트 (오늘 끝낸 게임이 아니면 0)

bettingPoint

Number

게임 시작 베팅 포인트

remainedSecond

Number

이번 라운드 남은 초. ms 단위는 버림해서 내려갑니다.