docs: 添加Postman配置文件和更新API文档

添加Postman环境配置和API集合文件，用于接口测试更新README和API文档，补充部署说明和接口细节
2025-12-09 15:00:57 +08:00
1 parent a46dd6eb74
commit 4a3e39d76d
@@ -0,0 +1,83 @@
+{
+  "info": {
+    "name": "PushToZhaoShang API",
+    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
+  },
+  "item": [
+    {
+      "name": "Metrics",
+      "request": { "method": "GET", "url": "{{baseUrl}}/api/metrics" }
+    },
+    {
+      "name": "Series7",
+      "request": { "method": "GET", "url": "{{baseUrl}}/api/series7?days=7" }
+    },
+    {
+      "name": "Revenue",
+      "request": { "method": "GET", "url": "{{baseUrl}}/api/revenue?days=30" }
+    },
+    {
+      "name": "Audit",
+      "request": { "method": "GET", "url": "{{baseUrl}}/api/audit?days=30" }
+    },
+    {
+      "name": "Health",
+      "request": { "method": "GET", "url": "{{baseUrl}}/api/health" }
+    },
+    {
+      "name": "Export CSV",
+      "request": { "method": "GET", "url": "{{baseUrl}}/api/export" }
+    },
+    {
+      "name": "Root",
+      "request": { "method": "GET", "url": "{{baseUrl}}/" }
+    },
+    {
+      "name": "Admin Page",
+      "request": { "method": "GET", "url": "{{baseUrl}}/admin" }
+    },
+    {
+      "name": "Admin Turnover",
+      "request": {
+        "method": "PUT",
+        "header": [ { "key": "X-Admin-Token", "value": "{{adminToken}}" }, { "key": "Content-Type", "value": "application/json" } ],
+        "body": { "mode": "raw", "raw": "{\n  \"date\": \"2025-12-06\",\n  \"amount\": 3123.45,\n  \"reason\": \"调整入账\",\n  \"actor\": \"admin\"\n}" },
+        "url": "{{baseUrl}}/api/admin/turnover"
+      }
+    },
+    {
+      "name": "Admin Test Push",
+      "request": {
+        "method": "POST",
+        "header": [ { "key": "X-Admin-Token", "value": "{{adminToken}}" }, { "key": "Content-Type", "value": "application/json" } ],
+        "body": { "mode": "raw", "raw": "{\n  \"date\": \"2025-12-09\",\n  \"amount\": 1234.56,\n  \"reason\": \"manual_test\"\n}" },
+        "url": "{{baseUrl}}/api/admin/test_push"
+      }
+    },
+    {
+      "name": "Admin Import CSV",
+      "request": {
+        "method": "POST",
+        "header": [ { "key": "X-Admin-Token", "value": "{{adminToken}}" }, { "key": "Content-Type", "value": "text/csv" } ],
+        "body": { "mode": "raw", "raw": "date,amount\n2025-12-01,12345.67\n2025-12-02,11890.12\n" },
+        "url": "{{baseUrl}}/api/admin/import"
+      }
+    },
+    {
+      "name": "Admin Logs",
+      "request": {
+        "method": "GET",
+        "header": [ { "key": "X-Admin-Token", "value": "{{adminToken}}" } ],
+        "url": "{{baseUrl}}/api/admin/logs?lines=200"
+      }
+    },
+    {
+      "name": "Admin Reload Cutoff",
+      "request": {
+        "method": "POST",
+        "header": [ { "key": "X-Admin-Token", "value": "{{adminToken}}" } ],
+        "url": "{{baseUrl}}/api/admin/reload_cutoff"
+      }
+    }
+  ]
+}