From 78459ffe7e833a7aec5089542bfaa623e5b16ebf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=90=B4=E5=B1=95=E9=B9=8F?= <wsh5485@163.com>
Date: Tue, 25 Nov 2025 17:57:27 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E6=97=BA=E9=93=BA?=
 =?UTF-8?q?=E6=8E=88=E6=9D=83API=E6=A8=A1=E6=8B=9F=E6=9C=8D=E5=8A=A1?=
 =?UTF-8?q?=E7=9A=84README=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

添加项目README文档，包含项目简介、功能特性、环境要求、安装部署步骤、使用方法、auth.json文件说明和开发说明等内容。文档详细说明了如何部署和使用该API模拟服务，以及如何修改配置文件和Nginx设置。
---
 README.md | 103 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8085c56
--- /dev/null
+++ b/README.md
@@ -0,0 +1,103 @@
+# 旺铺授权API 模拟服务
+
+## 项目简介
+
+本项目是一个简单的PHP API模拟服务，用于模拟旺铺授权信息的获取功能。该服务会接收请求，并根据请求中的token参数动态替换响应中的token值后返回固定格式的JSON响应。
+
+## 功能特性
+
+1. **固定JSON响应**：基于auth.json文件返回固定格式的设备认证信息
+2. **动态Token替换**：自动从请求URL中获取token参数并替换响应中的token值
+3. **跨域支持**：允许所有来源的跨域请求
+4. **Nginx伪静态支持**：忽略请求路径和查询参数，确保所有请求都能正确处理
+
+## 环境要求
+
+- PHP 5.6+ 或 PHP 7.x
+- Web服务器：Nginx（推荐）
+- Windows 或 Linux 操作系统
+
+## 安装部署
+
+### 1. 下载项目文件
+
+将以下文件放入您的Web服务器根目录或子目录：
+- `index.php` - API入口文件
+- `auth.json` - 包含默认授权信息的JSON文件
+- `nginx伪静态` - Nginx重写规则配置文件
+
+### 2. 配置Web服务器
+
+#### Nginx配置
+
+1. 打开Nginx配置文件（通常位于 `nginx/conf/nginx.conf` 或 `/etc/nginx/nginx.conf`）
+2. 在 `http` 块中的 `server` 配置中添加或修改以下内容：
+
+
+    # 将所有请求重定向到index.php
+    location / {
+        # 检查请求的文件或目录是否存在
+        if (!-e $request_filename) {
+            # 保留查询字符串，重写所有请求到index.php
+            rewrite ^/(.*)$ /index.php?$args last;
+        }
+    }
+
+
+
+
+## 使用方法
+
+### 基本使用
+1，创建网站，域名写为`wangpu.baison.com.cn`
+2，将项目文件放入网站根目录
+3，配置Nginx伪静态，将所有请求重定向到`index.php`
+4，重启Nginx服务
+5，配置公司NAS的adguard，将`wangpu.baison.com.cn`指向服务器IP(劫持)
+6，测试访问`http://wangpu.baison.com.cn/api/sys/devicereg/getaccreditinfo3000j?from=1&tenantcode=0&timestamp=20251125170440&token=82DBFF99-D114-4DBD-85E5-3AEE1004A857&version=3.0.3`，如果返回固定的JSON响应，说明配置成功（apifox）
+7，旺铺ipad链接办公室内和nas同网段wifi，DNS地址改成NAS的IP
+8，旺铺打开左下角 终端注册，点击那串子token
+9，授权完成
+
+### 功能说明
+
+- **token替换**：API会自动从请求URL中提取`token`参数值，并替换`auth.json`中`data.Token`字段的值
+- **固定响应结构**：除token外，其他响应数据保持不变，均来自`auth.json`文件
+- **忽略路径**：不管URL路径是什么，API都会返回相同的响应（由Nginx伪静态配置确保）
+
+## auth.json文件说明
+
+`auth.json`文件包含了默认的授权信息结构，格式如下：
+
+```json
+{
+    "status": "success",
+    "message": "3000+旺铺授权信息",
+    "data": {
+        "TenantCode": 533,
+        "TenantName": "名思图",
+        "Token": "默认Token值",
+        "AppId": "DA9363E9-692A-4D3C-AFD4-F28CF3113980",
+        "RegDate": "2023-11-29T17:04:48",
+        "ExpDate": "2099-11-27T17:04:48",
+        "Timestamp": "2024-11-24T16:58:59",
+        "AuditState": 0,
+        "AccreditCount": 0,
+        "Funcs": [
+            // 功能模块配置
+        ]
+    }
+}
+```
+
+您可以根据需要修改此文件中的默认值（除了Token字段，该字段会被请求中的token参数覆盖）。
+
+
+
+## 开发说明
+
+- 如需修改API响应的默认内容，请编辑`auth.json`文件
+- 如需修改API的处理逻辑，请编辑`index.php`文件
+- 如需调整URL重写规则，请修改Nginx配置
+
+