CKB-Interface/application/store/quick_organize.md

快速整理Agent接口 - 3步完成

⚠️ Apifox API限制说明

Apifox的公开API不支持创建目录功能（会重定向到帮助页面），需要通过Web界面手动创建。

📋 快速操作步骤（1分钟完成）

方法一：Web界面拖拽（最快）

1. 打开Apifox项目

   https://app.apifox.com/project/6037107
   

2. 创建目录

   • 在左侧找到"门店端-新版"
   • 右键点击 → 选择"新建目录"
   • 输入名称：Agent管理
   • 点击确认

3. 移动接口

   • 找到这2个接口（在"门店端-新版"根目录下）：
     • GET /v2/store/agent/modules
     • PUT /v2/store/agent/modules/{moduleCode}/status
   • 直接拖拽到"Agent管理"目录中

完成！ ✅

---

方法二：手动创建 + 脚本移动

如果你更喜欢使用脚本，可以按以下步骤：

1. 在Apifox中创建"Agent管理"目录

   • 打开 https://app.apifox.com/project/6037107
   • 在"门店端-新版"下创建"Agent管理"子目录

2. 获取目录ID

   • 在"Agent管理"目录上右键 → 复制
   • 或者在目录URL中查看ID

3. 运行移动脚本

   cd F:\karuo\yi-shi\Server\application\store
   
   # 替换 <目录ID> 为实际的Agent管理目录ID
   python apifox_manager.py move 415861964 <目录ID>
   python apifox_manager.py move 415861967 <目录ID>
   

---

🎯 完成后的目录结构

门店端-新版 (78015216)
├── 登录相关 (78092117)
│   ├── POST /v2/store/auth/login
│   ├── GET /v2/store/auth/login
│   ├── POST /v2/store/auth/send-code
│   └── POST /v2/store/auth/mobile-login
└── Agent管理 (新创建)
    ├── GET /v2/store/agent/modules
    └── PUT /v2/store/agent/modules/{moduleCode}/status

---

💡 为什么不能自动创建？

Apifox的REST API对目录创建功能有限制，调用会返回：

HTTP 200 → 重定向到 https://www.apifox.cn/help/

这是Apifox平台的安全策略，防止通过API批量创建目录结构。 好消息是Web界面操作非常快，只需要30秒！

---

📝 相关文件

• 接口信息：AGENT_APIFOX_SUCCESS.md
• 移动工具：apifox_manager.py
• OpenAPI规范：agent_openapi.json（用于文档参考）