From a2e9f5e35dd669ac8de4a8bcd563bb77ecc781fb Mon Sep 17 00:00:00 2001
From: QiuSW <105186638@qq.com>
Date: Mon, 14 Sep 2026 18:02:07 +0800
Subject: [PATCH] docs: add shopee http client cli example

---
 http-client-cli_file/README.md         |  5 +++++
 http-client-cli_file/shopee_synch.http | 11 +++++++++++
 2 files changed, 16 insertions(+)
 create mode 100644 http-client-cli_file/README.md
 create mode 100644 http-client-cli_file/shopee_synch.http

diff --git a/http-client-cli_file/README.md b/http-client-cli_file/README.md
new file mode 100644
index 0000000..dbdf485
--- /dev/null
+++ b/http-client-cli_file/README.md
@@ -0,0 +1,5 @@
+# HTTP Client CLI 测试实例
+
+本目录保存 ERPGo HTTP Client CLI 请求实例。
+
+`shopee_synch.http` 调用 Shopee 缓存优先同步查询接口。请求需要通过 `X-API-Key` 传入本地环境变量 `API_KEY`，文件中不保存真实密钥。
diff --git a/http-client-cli_file/shopee_synch.http b/http-client-cli_file/shopee_synch.http
new file mode 100644
index 0000000..ed1876d
--- /dev/null
+++ b/http-client-cli_file/shopee_synch.http
@@ -0,0 +1,11 @@
+### Shopee 商品缓存优先同步查询
+# 使用 HTTP Client CLI 前，请将 API_KEY 设置为本地环境变量。
+# 不要把真实 API Key 直接写入此文件。
+
+POST http://127.0.0.1:8020/api/v1/shopee/products/24720421377/synch?cacheday=1&syncday=3
+X-API-Key: {{API_KEY}}
+Accept: application/json
+
+### 预期行为
+# cacheday=1：ERPGo 本地缓存 1 天内直接返回；
+# syncday=3：货憨憨 3 天内同步过 Shopee 时不重复同步。