打卡记录幂等字段约束

概述

打卡记录中包含用于防重的幂等字段，可保障重复请求不会造成重复入账或重复打卡。

关键字段

字段	类型	必填	默认值	说明
checkinAt	datetime	是	当前时间	打卡时间
idempotencyKey	string	是	-	幂等键

实践建议

• 每次打卡请求必须携带唯一 idempotencyKey。
• 服务端应基于 idempotencyKey 做去重处理，防止网络重试导致重复创建记录。
• 若打卡会触发积分变更，应将幂等控制扩展到积分流水写入。
• 推荐将幂等键与 userId + 业务场景 组合校验，提高唯一性和安全性。