> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/developers/action-data/api-references.md).

# API 레퍼런스

<figure><img src="https://2560922032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyYVX6HW5LNuPHRnSB2po%2Fuploads%2F7sIs9ruhbaku0zcpLVMJ%2FAPI%20%E1%84%85%E1%85%A6%E1%84%91%E1%85%A5%E1%84%85%E1%85%A5%E1%86%AB%E1%84%89%E1%85%B3.png?alt=media&amp;token=e3ad7967-e136-4965-b938-192c84d0895e" alt=""><figcaption></figcaption></figure>

#### genser 이벤트 수집 API 규격

genser의 이벤트 수집 API는 시스템 간 호환성과 명확한 데이터 의미 전달을 위해 글로벌 표준 기술을 기반으로 설계되었습니다. 이벤트의 최상위 전송 규격은 **CNCF의 CloudEvents 1.0을 준수**하여 다양한 클라우드 환경에서의 표준화된 처리를 보장합니다.&#x20;

또한, 실제 사용자 행동 데이터는 **Schema.org의 Action 모델**을 채택하여 '행위자(Agent)-대상(Object)-목표(Target)'의 문맥을 구조적으로 정의합니다. 이러한 표준화된 설계를 통해 개발자는 예측 가능한 구조로 손쉽게 연동할 수 있으며, 비즈니스 환경에 맞는 데이터의 투명성과 확장성을 확보할 수 있습니다.

**주요 준수 규격:**

* 전송 포맷: CloudEvents 1.0 (이벤트 라우팅 및 메타데이터 식별)
* 데이터 모델: Schema.org Actions (사용자 행동의 구조적 표현)