ovopark-api

Provides nodes to authenticate and call 万店掌 Ovopark API with flexible parameter and token management.AI-generated

Package Information

Released: 4 mo ago
Downloads: 16 weekly / 128 monthly
Latest Version: 0.1.2
Author: xAmast

Available Nodes

万店掌 API icon
万店掌 API
万店掌开放平台 API

Documentation

@waywake/n8n-nodes-ovopark-api

万店掌开放平台 n8n community node，底层通过 @waywake/ovopark-sdk 调用网关。

功能

  • 使用 OpenPlatform SDK 自动生成 _sig 并提交表单请求
  • SDK 签名参数使用确定的字典序排序，兼容包含大小写混合字段名的接口
  • 支持自定义网关 URL、App ID、AccessKey ID、AccessKey Secret、版本和请求模式
  • 支持独立的 Get User Token 操作，通过用户名密码获取短期 Ovo-Authorization
  • 支持在节点参数中传入短期有效的 Ovo-Authorization 请求头
  • 支持每个输入 item 通过表达式传入不同 API 方法和业务参数
  • 使用 Bun 管理依赖并通过 bun build 打包节点

开发

bun install
bun run typecheck
bun run lint
bun run build

构建产物输出到 dist，n8n 会加载：

  • dist/credentials/OvoparkApi.credentials.js
  • dist/credentials/OvoparkUserApi.credentials.js
  • dist/nodes/OvoparkApi/OvoparkApi.node.js

节点参数

Ovopark API Credentials:

  • Gateway URL: 默认 https://cloudapi.ovopark.com/cloud.api
  • App ID: 对应 _aid，留空时使用 SDK 默认值 S107
  • Access Key ID: 对应 _akey
  • Access Key Secret: 用于生成 _sig
  • Version: 对应 _version，默认 v1
  • Request Mode: 对应 _requestMode，默认 POST

Ovopark User API Credentials:

  • Username: 万店掌用户名
  • Password: 万店掌密码，节点会按 SDK 示例转换为 MD5 后发送

Node:

  • Operation: Call API 或 Get User Token
  • Method: API 方法名，对应 _mt
  • Request Parameters: 业务参数 JSON object
  • Timeout: 请求超时时间，单位毫秒，0 表示禁用超时
  • Additional Headers: 额外请求头 JSON object
  • Ovo Authorization: 短期有效 token，可用表达式从上游登录结果传入，发送为 Ovo-Authorization header

Get User Token 会调用 open.shopweb.security.ssoLogin，并输出 ovoAuthorization 字段，可在后续 Call API 节点中通过表达式引用。

示例

Method:

open.organize.departments.getDepartments

Request Parameters:

{
	"pageNumber": "1",
	"pageSize": "20"
}

License

MIT

Discussion