万店掌 API icon

万店掌 API

万店掌开放平台 API

Actions2

Call API

AI-generated

Summary

Calls any Ovopark (万店掌) open-platform API method through the signed gateway, sending the given business parameters and returning the parsed response for each input item.

Inputs

  • method (required) — Ovopark API method name, sent as _mt (e.g. open.organize.departments.getDepartments). Trimmed; an empty value throws an error.
  • params — JSON object of business parameters. Merged with the gateway parameters and signed (MD5 with the access key secret). Nested objects and arrays are JSON-stringified; it must be a JSON object, not an array.
  • timeoutMs — Request timeout in milliseconds. Default is 30000. Use 0 to disable the timeout.
  • headers — JSON object of extra HTTP headers. Values are converted to strings, and null or undefined values are skipped.
  • authorization — Ovo-Authorization token, for APIs that need a login token. If set, it is sent as the Ovo-Authorization header and overrides any header of that name in Additional Headers. You can get one with the Get User Token operation.

Output shape

One output item per input item. Its json is the gateway response body, parsed as JSON when possible.

Non-object responses are wrapped as {data: ...}; arrays also become {data: [...]}. An empty response body gives {data: undefined}. A non-2xx HTTP status throws an error. With Continue On Fail enabled, a failing item returns {error: message} instead. The required ovoparkApi credential supplies the gateway URL, app ID, access key ID and secret, version, and request mode. Items are paired with their input via pairedItem.

Examples

Example 1: Fetch the department list from Ovopark

Method = open.organize.departments.getDepartments, Request Parameters = {} (or the filters the API requires), default timeout.

Example 2: Call an API that needs a login token

Run Get User Token first, then set Ovo Authorization to an expression such as {{ $json.token }}, and set Method and Request Parameters for the target API.

Links

Discussion