青龙面板[Qinglong] icon

青龙面板[Qinglong]

青龙面板计划任务节点.详细API请参考:https://qinglong.online/api/

Overview

This node integrates with the QingLong Panel API to manage dependencies in an automated workflow. Specifically, for the "依赖管理" (Dependency Management) resource and the "更新依赖" (Update Dependency) operation, it allows users to update existing dependencies by sending updated information such as dependency ID, name, type, and optional remarks.

Common scenarios where this node is beneficial include:

  • Automating updates of software dependencies on a QingLong-managed environment.
  • Managing different types of dependencies like Node.js packages, Python3 modules, or Linux system dependencies.
  • Keeping dependency metadata up-to-date programmatically within n8n workflows.

Practical example:

  • A user wants to update the version or description of a Node.js package dependency managed by QingLong. They configure this node to specify the dependency type as "nodejs" and provide the updated details in JSON format. The node then sends the update request to QingLong's API.

Properties

Name Meaning
类型 依赖类型。可选值包括:nodejspython3linux,分别代表不同的依赖环境或语言类型。
请求Body 发送给API的请求体,格式为JSON。包含字段:
- id: 依赖ID(数字)
- name: 依赖名称(字符串)
- type: 依赖类型(数字)
- remark: 备注(可选,字符串)

Output

The node outputs the result of the QingLong API call in the json field of the first item of the output data array under the property result. This typically contains the response from the QingLong server confirming the update status or any returned data related to the updated dependency.

No binary data output is involved in this operation.

Example output structure:

{
  "result": {
    // API response object indicating success or failure of the update
  }
}

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests against the QingLong Panel API.
  • The node uses the QingLong API endpoint /open/dependencies with HTTP method PUT for updating dependencies.
  • Proper network access to the QingLong API server is necessary.

Troubleshooting

  • Common issues:

    • Incorrect or missing API authentication token will cause authorization failures.
    • Providing invalid or incomplete JSON in the "请求Body" property may lead to API errors.
    • Specifying a non-existent dependency ID will result in not found errors.
    • Mismatched dependency type values between the property and the body can cause update failures.
  • Error messages:

    • "任务模块的[operation]操作暂未实现" means the requested operation is not implemented; ensure you selected the correct operation.
    • API errors returned from QingLong will be surfaced as node errors; check the message for details.
  • Resolution tips:

    • Verify the API credentials and permissions.
    • Validate the JSON structure and required fields before execution.
    • Confirm the dependency ID exists in QingLong.
    • Match the dependency type consistently across parameters.

Links and References

  • QingLong Panel API documentation: https://qinglong.online/api/
  • QingLong GitHub repository and community resources (search online for latest links).

Discussion