Game api protocol - SG-Finder/auth_server GitHub Wiki

Get Player Info In Game

Request

  • endpoint: GET /finder/player/{nickname}
  • header
Key Value Type Info
session-token askfziouh&%=as string ์„ธ์…˜ํ† ํฐ

Response

Success

  • status code: 200
  • body
Key Value Type Info
nickname Zookeeper string ํ”Œ๋ ˆ์ด์–ด์˜ ๋‹‰๋„ค์ž„
tier BRONZE string ํ”Œ๋ ˆ์ด์–ด์˜ ํ‹ฐ์–ด
score 0 int ํ”Œ๋ ˆ์ด์–ด์˜ ์ ์ˆ˜
history data json object ํ”Œ๋ ˆ์ด์–ด์˜ ํžˆ์Šคํ† ๋ฆฌ ์ •๋ณด
weapon [ knife, gun ] json array ํ”Œ๋ ˆ์ด์–ด์˜ ๋ฌด๊ธฐ ์ •๋ณด
point 0 int ํ”Œ๋ ˆ์ด์–ด์˜ ํฌ์ธํŠธ

history data

Key Value Type Info
win 12 int ์Šน๋ฆฌ ํšŸ์ˆ˜
lose 2 int ํŒจ๋ฐฐ ํšŸ์ˆ˜
oneShot 123 int ํ•œ๋ฒˆ์— ์ ์„ ์ฐพ๋Š” ๋ฏธ์…˜ ๋‹ฌ์„ฑ ํšŸ์ˆ˜
finder 125 int ์งง์€ ์‹œ๊ฐ„์•ˆ์— ์ ์„ ์ฐพ๋Š” ๋ฏธ์…˜ ๋‹ฌ์„ฑ ํšŸ์ˆ˜
lastWeekRank 0 int ํ”Œ๋ ˆ์ด์–ด์˜ ๋žญํฌ(ref: ํ•œํŒ๋„ ์‹คํ–‰ํ•˜์ง€ ์•Š์•˜์œผ๋ฉด 0)

weapon data

Key Value Type Info
name knife string ๋ฌด๊ธฐ ์ด๋ฆ„
damage 50 int ๋ฌด๊ธฐ ๋ฐ๋ฏธ์ง€
price 100 int ๋ฌด๊ธฐ ๊ฐ€๊ฒฉ
usableCount 1 int ๋ฌด๊ธฐ ๋ณด์œ ๋Ÿ‰

Fail

  • body
Key Value Type Info
code 409 int ์—๋Ÿฌ ์ฝ”๋“œ
message ํ† ํฐ์ด ๋งŒ๋ฃŒ ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. string ์—๋Ÿฌ ๋ฉ”์‹œ์ง€

Fail์ด ๋  ์ˆ˜ ์žˆ๋Š” ๊ฒฝ์šฐ

400 : BAD_REQUEST

  • path variable์ด null์ผ ๊ฒฝ์šฐ

404 : NOT FOUND

  • ํ•ด๋‹น ๋‹‰๋„ค์ž„์„ ๊ฐ€์ง„ ํ”Œ๋ ˆ์ด์–ด๊ฐ€ ์—†์„ ๊ฒฝ์šฐ

409 : UNAUTHORIZED

  • header์— ํ† ํฐ์ด ์—†๊ฑฐ๋‚˜ ๋งŒ๋ฃŒ์ผ ๊ฒฝ์šฐ

500 : INTERNAL SERVER ERROR