青龙面板[Qinglong] icon

青龙面板[Qinglong]

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

Actions64

Overview

This node integrates with the QingLong Panel API to manage scheduled tasks and related resources. Specifically, for the "定时任务" (Scheduled Task) resource and the "更新视图" (Update View) operation, it updates an existing view configuration in the QingLong system.

Use cases include automating the modification of task views such as changing the view's name, sorting rules, filters, or filter relations programmatically within a workflow. This is useful when you want to dynamically adjust how scheduled tasks are displayed or filtered based on external conditions or triggers.

Example: Automatically update a view to change its sorting order or filters after certain events, ensuring that the task dashboard reflects the most relevant information.

Properties

Name Meaning
请求Body JSON object containing the view update details. It includes:
- id: View ID (number)
- name: View name (string)
- sorts: Sorting rules (Array)
- filters: Filtering rules (Array)
- filterRelation: Filter relation (string)

The property expects a JSON structure describing the updated view attributes.

Output

The node outputs the JSON response from the QingLong API under the field json.result. This typically contains the result of the update operation, such as confirmation of success or details of the updated view.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating with the QingLong Panel API.
  • The node uses internal helper functions to obtain tokens and make HTTP requests to QingLong endpoints.
  • The base URL and authentication must be configured properly in the n8n credentials for QingLong API access.

Troubleshooting

  • Common issues:

    • Invalid or expired API token leading to authentication errors.
    • Incorrect or incomplete JSON body causing API validation failures.
    • Specifying a non-existent view ID will cause the update to fail.

  • Error messages:

    • "任务模块的[operation]操作暂未实现" ("The [operation] operation of the task module is not yet implemented"): Indicates an unsupported operation was selected.
    • API errors returned by QingLong will be wrapped and thrown as node errors; check the message for details.

  • Resolutions:

    • Verify API credentials and refresh tokens if necessary.
    • Ensure the JSON body matches the expected schema and all required fields are provided.
    • Confirm the view ID exists before attempting an update.

Links and References

Discussion