n8n-nodes-kuaimai 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -28
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -5,7 +5,20 @@
|
|
|
5
5
|
[](https://www.npmjs.com/package/n8n-nodes-kuaimai)
|
|
6
6
|
[](https://opensource.org/licenses/MIT)
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
> **⚠️ 测试版本警告**
|
|
9
|
+
>
|
|
10
|
+
> 此项目目前为 **测试版本 (Beta)**，仍在开发和完善中。
|
|
11
|
+
>
|
|
12
|
+
> **重要安全提示：**
|
|
13
|
+
>
|
|
14
|
+
> - **生产数据**：请勿在生产环境中使用此节点处理真实的业务数据
|
|
15
|
+
> - **API 凭证**：仅使用测试环境的 API 密钥和访问令牌
|
|
16
|
+
> - **数据备份**：定期备份您的工作流和配置
|
|
17
|
+
> - **功能限制**：部分 API 功能可能尚未完全实现或存在稳定性问题
|
|
18
|
+
>
|
|
19
|
+
> 我们建议在测试环境中充分验证节点功能后再考虑生产部署。
|
|
20
|
+
|
|
21
|
+
## 目录
|
|
9
22
|
|
|
10
23
|
- [特性](#特性)
|
|
11
24
|
- [安装](#安装)
|
|
@@ -16,16 +29,16 @@
|
|
|
16
29
|
- [常见问题](#常见问题)
|
|
17
30
|
- [许可证](#许可证)
|
|
18
31
|
|
|
19
|
-
##
|
|
32
|
+
## 特性
|
|
20
33
|
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
34
|
+
- **完整的 API 支持**：基于快麦开放平台官方文档实现
|
|
35
|
+
- **安全认证**：支持 HMAC-MD5、MD5、HMAC-SHA256 签名算法
|
|
36
|
+
- **会话管理**：自动处理 Token 刷新（30天有效期）
|
|
37
|
+
- **资源管理**：订单、商品、仓库、基础数据查询
|
|
38
|
+
- **易于使用**：可视化配置，无需编写代码
|
|
39
|
+
- **Docker 部署**：提供完整的 Docker Compose 配置
|
|
27
40
|
|
|
28
|
-
##
|
|
41
|
+
## 安装
|
|
29
42
|
|
|
30
43
|
### 方式一：Docker Compose（推荐）
|
|
31
44
|
|
|
@@ -66,7 +79,7 @@ docker-compose logs -f n8n
|
|
|
66
79
|
npm install @gabrielsworld/n8n-node-kuaimai --registry=https://npm.pkg.github.com
|
|
67
80
|
```
|
|
68
81
|
|
|
69
|
-
##
|
|
82
|
+
## 快速开始
|
|
70
83
|
|
|
71
84
|
### 1. 获取快麦 API 凭证
|
|
72
85
|
|
|
@@ -114,17 +127,17 @@ npm install @gabrielsworld/n8n-node-kuaimai --registry=https://npm.pkg.github.co
|
|
|
114
127
|
└── 查询库存
|
|
115
128
|
```
|
|
116
129
|
|
|
117
|
-
##
|
|
130
|
+
## 配置说明
|
|
118
131
|
|
|
119
132
|
### 签名方法
|
|
120
133
|
|
|
121
134
|
快麦开放平台支持三种签名算法：
|
|
122
135
|
|
|
123
|
-
| 方法 | 说明 | 安全性
|
|
124
|
-
| ------------ | ------------------------- |
|
|
125
|
-
| **HMAC-MD5** | HMAC 消息认证码（MD5） |
|
|
126
|
-
| MD5 | 简单 MD5 摘要 |
|
|
127
|
-
| HMAC-SHA256 | HMAC 消息认证码（SHA256） |
|
|
136
|
+
| 方法 | 说明 | 安全性 | 推荐 |
|
|
137
|
+
| ------------ | ------------------------- | ------ | ------ |
|
|
138
|
+
| **HMAC-MD5** | HMAC 消息认证码（MD5） | 高 | 推荐 |
|
|
139
|
+
| MD5 | 简单 MD5 摘要 | 中 | 不推荐 |
|
|
140
|
+
| HMAC-SHA256 | HMAC 消息认证码（SHA256） | 很高 | 推荐 |
|
|
128
141
|
|
|
129
142
|
### 会话管理
|
|
130
143
|
|
|
@@ -132,7 +145,7 @@ npm install @gabrielsworld/n8n-node-kuaimai --registry=https://npm.pkg.github.co
|
|
|
132
145
|
- **刷新**：必须在会话过期前调用 **刷新会话** 操作
|
|
133
146
|
- **限制**：刷新接口每小时最多调用 1 次
|
|
134
147
|
|
|
135
|
-
|
|
148
|
+
**重要**：建议每月至少刷新一次会话，避免 Token 过期。
|
|
136
149
|
|
|
137
150
|
### API 环境
|
|
138
151
|
|
|
@@ -141,7 +154,7 @@ npm install @gabrielsworld/n8n-node-kuaimai --registry=https://npm.pkg.github.co
|
|
|
141
154
|
| V2正式环境（推荐） | `https://gw.superboss.cc/router` | 2022年4月1日后申请的 App Key 使用 |
|
|
142
155
|
| V2内部专用 | `https://gw3.superboss.cc/router` | 内部测试使用 |
|
|
143
156
|
|
|
144
|
-
##
|
|
157
|
+
## 支持的操作
|
|
145
158
|
|
|
146
159
|
### 基础操作
|
|
147
160
|
|
|
@@ -226,7 +239,7 @@ npm install @gabrielsworld/n8n-node-kuaimai --registry=https://npm.pkg.github.co
|
|
|
226
239
|
|
|
227
240
|
**API 方法**：`erp.inventory.query`
|
|
228
241
|
|
|
229
|
-
##
|
|
242
|
+
## 开发指南
|
|
230
243
|
|
|
231
244
|
### 环境要求
|
|
232
245
|
|
|
@@ -287,7 +300,7 @@ npm run format
|
|
|
287
300
|
|
|
288
301
|
详细开发指南请参考 [AGENTS.md](./AGENTS.md)。
|
|
289
302
|
|
|
290
|
-
##
|
|
303
|
+
## 常见问题
|
|
291
304
|
|
|
292
305
|
### 1. 节点不显示？
|
|
293
306
|
|
|
@@ -329,7 +342,7 @@ docker-compose restart n8n
|
|
|
329
342
|
- 刷新会话接口：每小时 1 次
|
|
330
343
|
- 其他接口：具体限制请参考快麦开放平台文档
|
|
331
344
|
|
|
332
|
-
##
|
|
345
|
+
## 相关文档
|
|
333
346
|
|
|
334
347
|
- [快速开始指南](./QUICKSTART.md)
|
|
335
348
|
- [Docker 部署文档](./DOCKER_DEPLOYMENT.md)
|
|
@@ -337,20 +350,20 @@ docker-compose restart n8n
|
|
|
337
350
|
- [开发指南](./AGENTS.md)
|
|
338
351
|
- [快麦开放平台官方文档](https://open.kuaimai.com/)
|
|
339
352
|
|
|
340
|
-
##
|
|
353
|
+
## 贡献
|
|
341
354
|
|
|
342
355
|
欢迎提交 Issue 和 Pull Request！
|
|
343
356
|
|
|
344
|
-
##
|
|
357
|
+
## 许可证
|
|
345
358
|
|
|
346
359
|
[MIT License](LICENSE)
|
|
347
360
|
|
|
348
|
-
##
|
|
361
|
+
## 支持
|
|
349
362
|
|
|
350
|
-
-
|
|
351
|
-
-
|
|
352
|
-
-
|
|
363
|
+
- Email: gabrielsworld@github.com
|
|
364
|
+
- Issues: https://github.com/gabrielsworld/n8n-nodes-kuaimai/issues
|
|
365
|
+
- 文档: https://open.kuaimai.com/
|
|
353
366
|
|
|
354
367
|
---
|
|
355
368
|
|
|
356
|
-
**Made
|
|
369
|
+
**Made by gabrielsworld**
|