---
url: https://developers.webzenk.kr/api/events.md
---
# 이벤트

| | 경로 | 인증 | 설명 |
|---|---|---|---|
| POST | `/v1/events` | 유저 | 이벤트 전송 (최대 100건) |

```json
{
  "platform": "android",
  "app_version": "1.2.0",
  "events": [
    { "name": "stage_clear", "ts": 1795055466123, "props": { "stage": 12 } },
    { "name": "tutorial_done" }
  ]
}
```

| 필드 | 규칙 |
|---|---|
| `platform` | 선택. 소문자 2~16자 (`android`, `ios`, `web`, `samsung` …) |
| `app_version` | 선택. 32자 이내 |
| `events[].name` | 소문자로 시작하는 `[a-z0-9_]` 64자 |
| `events[].ts` | 선택. epoch 초 또는 밀리초. 생략하거나 7일보다 오래됐거나 미래면 받은 시각 |
| `events[].props` | 선택. 4KB 이내 객체 |

* 하나라도 형식이 틀리면 전체가 `400`입니다(일부만 저장되지 않습니다). 오프라인 큐에서 그대로 재전송하면 됩니다.
* 유저당 하루 5,000건을 넘으면 `429 EVENT_QUOTA_EXCEEDED`입니다.
* 집계 결과는 [개발사 서버 API](./server#지표)의 `/v1/server/metrics/events`로 조회합니다.
