返回列表
时间戳在API设计中的最佳实践
1. 统一使用UTC时间戳
API接口应统一使用UTC时间戳,避免时区混乱。客户端收到后自行转换为本地时间。
2. 明确时间戳单位
在API文档中必须明确说明时间戳是秒级还是毫秒级。建议在参数名中体现,如 timestamp_sec 或 timestamp_ms。
3. 时间范围参数
{
"start_time": 1748016000,
"end_time": 1748102400
}
4. 过期时间设计
使用时间戳表示资源的过期时间,便于客户端判断缓存是否有效。
5. 签名防重放
在请求参数中加入时间戳,服务端验证时间戳是否在合理范围内(如5分钟内),防止重放攻击。
6. 处理时区敏感场景
对于时区敏感的业务(如日历、日程),建议同时存储时间戳和时区偏移量。