---
url: https://developers.webzenk.kr/guide.md
---
# 개요

웹젠케이 Game API는 게임에 필요한 서버 기능을 **별도 게임 서버 없이** 쓸 수 있게 해 주는 REST API예요.
로그인·데이터 저장·랭킹·지표 수집과 함께, 결제 영수증과 보상형 광고를 **스토어·광고사 서버에서 직접 검증**해 위조와 중복 지급을 막아요.

## 무엇을 할 수 있나요

| 기능 | 설명 |
|---|---|
| [로그인·계정](./login) | 게스트, Google, Play Games, Apple, 삼성 계정. 계정을 연결하면 기기를 바꿔도 진행이 이어져요 |
| [데이터 저장](./storage) | 유저별 키-값(JSON) 저장. 여러 기기의 동시 저장 충돌을 알려 줘요 |
| [랭킹](./ranking) | 일간·주간·월간 시즌, 최고·최신·누적 점수, 지난 시즌 결과 보관 |
| [지표·이벤트](./metrics) | DAU·신규·매출·리텐션 자동 집계와 커스텀 이벤트 |
| [결제 검증](./iap) | Google Play·App Store·삼성 Instant Plays 영수증 서버 검증, 환불 반영 |
| [보상형 광고](./ads) | AppLovin MAX 서버 콜백으로 광고 시청을 확인한 뒤 보상 |

## 연동 흐름

1. **[게임 등록](./registration)** — 운영 담당자에게 요청해 App Key·App Secret·Server Secret을 받아요.
2. **[SDK 선택·설치](./choose-sdk)** — Unity, HTML5 SDK 중 고르거나 REST API를 직접 호출해요.
3. **기능 연동** — 로그인부터 시작해서 필요한 기능을 붙여요.
4. **[테스트](./testing)** — 테스트 계정으로 결제·광고 보상까지 확인해요.
5. **[출시](./launch-checklist)** — 체크리스트를 확인하고 공개해요.

## 기본 정보

| 항목 | 값 |
|---|---|
| API 주소 | `https://game-api.webzenk.kr` |
| 프로토콜 | HTTPS, JSON (UTF-8) |
| 날짜 기준 | 게임 시간대 (기본 한국 시간) — 일일 한도·일간/주간/월간 랭킹·지표 |
| SDK | Unity `com.webzenk.wk-gameapi` · HTML5 `@webzenk/wk-gameapi` |

::: tip AI 도구로 연동하나요?
이 사이트의 모든 문서는 Markdown으로도 제공돼요. Claude Code·Codex 같은 도구에 [`/llms.txt`](/llms.txt)(목차)나 [`/llms-full.txt`](/llms-full.txt)(전체)를 넣어 주면 문서를 그대로 참고해요. 각 페이지 상단의 **페이지 복사** 버튼도 쓸 수 있어요.
:::
