返回列表
时间戳在API设计中的最佳实践
自由客七维 2026-05-23 12:01 44

1. 统一使用UTC时间戳

API接口应统一使用UTC时间戳,避免时区混乱。客户端收到后自行转换为本地时间。

2. 明确时间戳单位

在API文档中必须明确说明时间戳是秒级还是毫秒级。建议在参数名中体现,如 timestamp_sectimestamp_ms

3. 时间范围参数

{
      "start_time": 1748016000,
      "end_time": 1748102400
    }

4. 过期时间设计

使用时间戳表示资源的过期时间,便于客户端判断缓存是否有效。

5. 签名防重放

在请求参数中加入时间戳,服务端验证时间戳是否在合理范围内(如5分钟内),防止重放攻击。

6. 处理时区敏感场景

对于时区敏感的业务(如日历、日程),建议同时存储时间戳和时区偏移量。