FlowEvent(进出事件明细)
FlowEvent(进出事件明细)
Section titled “FlowEvent(进出事件明细)”按「事件」返回镜头区域的进出明细,同时覆盖进店顾客(限定从入口通道进入)与店内员工(常驻店内,不做入口过滤)。在 flowEvents 查询中使用。
query { flowEvents(storeId: 1, startDate: "2026-08-01", endDate: "2026-08-20", roles: [STAFF]) { peopleId eventType eventTime deviceSn zoneId role }}Fields
Section titled “Fields”| 字段 | 类型 | 说明 |
|---|---|---|
peopleId |
String! |
行人身份 ID(uuid) |
eventType |
FlowEventType! |
事件类型:ENTER / LEAVE |
eventTime |
String! |
事件发生时间,ISO8601(+08:00),如 2026-08-20T14:23:05+08:00 |
deviceSn |
String! |
拍摄/抓拍该事件的摄像头 SN |
zoneId |
Int! |
摄像头区域 ID |
role |
PeopleRole! |
行人身份:CUSTOMER(顾客)/ STAFF(员工)/ OTHER(其他) |
FlowEventType 枚举
Section titled “FlowEventType 枚举”| 值 | 说明 |
|---|---|
ENTER |
进入(进店) |
LEAVE |
离开(出店) |
Arguments
Section titled “Arguments”| 参数 | 类型 | 说明 |
|---|---|---|
storeId |
Int! |
门店 ID |
startDate |
String! |
起始日期,YYYY-MM-DD |
endDate |
String! |
结束日期,YYYY-MM-DD |
roles |
[PeopleRole!] |
可选。传 CUSTOMER 仅返回顾客(始终应用入口过滤),传 STAFF 仅返回员工,传 OTHER 仅返回其他身份;不传返回全部 |
身份过滤说明
Section titled “身份过滤说明”- 顾客(
CUSTOMER):仅包含有入口通道(pass_type=1)进入事件的顾客,过滤发生在服务端 —— 传不传roles都一样; - 员工(
STAFF):常驻店内、不走入口,不做入口过滤; - 不传
roles时返回「入口进店顾客 + 员工」的并集。