OPENAPI / COMPONENTS / SCHEMAS

采集单个事件

CaptureEventRequest

提交一个事件。事件、distinct_id 和项目令牌必填;200 只表示服务接收了格式正确的请求,不保证最终摄入。该请求可更新人物或群组资料,Hub 不代发。

object5字段
api_keystring必填

PostHog 项目令牌,只能从调用方本地配置注入。

distinct_idstring必填

事件或功能开关求值关联的用户 distinct ID;采集 API 最多保留前 200 个字符。

eventstring必填

要采集的事件名称。

propertiesobject

动态事件属性,可携带 $identify、$groupidentify、$groups、$process_person_profile 等官方事件属性。

timestampstring

可选的 ISO 8601 事件时间。