화면 모드
이벤트
| 경로 | 인증 | 설명 | |
|---|---|---|---|
| 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의
/v1/server/metrics/events로 조회해요.