---
url: https://developers.webzenk.kr/sdk.md
---
# API & SDK 한눈에 보기

기능별로 SDK 사용법과 REST API 문서를 모았어요. SDK를 쓰면 서명·토큰 갱신·결제 복구를 SDK가 처리해요.

| 기능 | 설명 | Unity | HTML5 | REST API |
|---|---|---|---|---|
| 초기화 | App Key(·Secret)로 SDK 시작 | [설치·시작](./unity/) | [설치·시작](./html5/) | [인증과 서명](/api/) |
| 로그인 | 게스트·Google·Play Games·Apple·삼성 계정, 계정 연결 | [로그인](./unity/features#로그인) | [로그인](./html5/features#로그인) | [로그인·계정](/api/auth) |
| 저장 | 유저별 JSON 저장, 충돌 시 재시도 | [저장](./unity/features#저장) | [저장](./html5/features#저장) | [데이터 저장](/api/storage) |
| 랭킹 | 점수 제출·순위·지난 시즌 | [랭킹](./unity/features#랭킹) | [랭킹](./html5/features#랭킹) | [랭킹](/api/leaderboards) |
| 이벤트 | 커스텀 이벤트 (모아서 전송) | [이벤트](./unity/features#이벤트) | [이벤트](./html5/features#이벤트) | [이벤트](/api/events) |
| 결제 | 스토어 결제 → 서버 검증 → 지급 → 완료 | [Unity IAP](./unity/iap) | [플랫폼 결제](./html5/iap-ads#결제) | [결제](/api/iap) |
| 보상형 광고 | 광고 시청 → 서버 확인 → 지급 | [AppLovin MAX](./unity/ads) | [플랫폼 광고](./html5/iap-ads#광고) | [보상형 광고](/api/ads) |
| 플랫폼 | 웹·삼성 Instant Plays | — | [플랫폼](./html5/platforms) | — |
| 지표 조회·환불 회수·제재 | 개발사 서버에서 | — | — | [개발사 서버 API](/api/server) |

## SDK 비교

| | Unity SDK | HTML5 SDK |
|---|---|---|
| 패키지 | `com.webzenk.wk-gameapi` (UPM) | `@webzenk/wk-gameapi` (npm) / `wk-gameapi.min.js` |
| 대상 | Unity 2022.3 LTS 이상, Android·iOS (WebGL은 웹 모드) | 웹사이트, 삼성 Instant Plays |
| 인증 | App Key + App Secret 서명 | App Key + 허용 도메인 |
| 결제 | Unity IAP 4.8+ (설치했을 때만 연결) | 플랫폼 결제 (삼성 IAP) |
| 광고 | AppLovin MAX (샘플 어댑터) | 플랫폼 광고 (Samsung Ads + AdMob) |
| 외부 의존 | 없음 (자체 JSON) | 없음 |
| 비동기 | `async`/`await` (Task) | `async`/`await` (Promise) |

[다운로드 →](./download)
