이벤트 수집(Ingestion) 단건/배치 API 구현

[HuitaePark]

목적

네트워크 비용 절감 및 대량 데이터 수집을 위해 단건 및 배치 사용량 이벤트 수집 API를 구현합니다.

요구 사항

• 단건 이벤트 수집 엔드포인트 구현 (POST /api/ingestion/events)
• 배치 이벤트 수집 엔드포인트 구현 (POST /api/ingestion/events/batch)
• Project API Key 기반 인증 시스템 연동
• projectKey + requestId 조합을 이용한 멱등성(Idempotency) 처리
• UsageLog 엔티티 저장 및 메타데이터 처리

API 명세 요약

1. 단건 수집

• Endpoint: POST /api/ingestion/events
• Auth: API Key

2. 배치 수집

• Endpoint: POST /api/ingestion/events/batch
• Auth: API Key

비고

• 이벤트 수집 후 집계 로직은 추후 비동기 처리로 확장 가능성을 고려하여 설계함.