From 4ba9ade790e01540af91aa41295cf4446f48d915 Mon Sep 17 00:00:00 2001
From: mediabot-pt <295750538+mediabot-pt@users.noreply.github.com>
Date: Mon, 29 Jun 2026 17:07:29 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=20GET=20/api/v1/time?=
 =?UTF-8?q?=20=E5=9F=BA=E5=87=86=E6=97=B6=E9=97=B4=E6=8E=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 返回服务端 Unix 时间戳（秒）
- 客户端签名前调用此接口获取 timestamp
- 避免跨服务器时钟偏差导致 PSK 签名过期
---
 .../par/api/controller/TimeController.java    | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 par-api/src/main/java/com/par/api/controller/TimeController.java

diff --git a/par-api/src/main/java/com/par/api/controller/TimeController.java b/par-api/src/main/java/com/par/api/controller/TimeController.java
new file mode 100644
index 0000000..7e2b895
--- /dev/null
+++ b/par-api/src/main/java/com/par/api/controller/TimeController.java
@@ -0,0 +1,25 @@
+package com.par.api.controller;
+
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Map;
+
+/**
+ * 基准时间接口
+ * 客户端签名前获取服务端时间戳，避免时钟偏差导致签名失效
+ */
+@RestController
+@RequestMapping("/api/v1")
+public class TimeController {
+
+    /**
+     * 返回服务端当前 Unix 时间戳（秒）
+     */
+    @GetMapping("/time")
+    public Map<String, Object> serverTime() {
+        long now = System.currentTimeMillis() / 1000;
+        return Map.of("timestamp", now, "unit", "seconds");
+    }
+}