青龙面板[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 "添加标签" (Add Tag) operation, it allows users to add labels to one or more scheduled tasks by sending a request with task IDs and label names.

Common scenarios include:

  • Organizing scheduled tasks by tagging them with meaningful labels.
  • Automating batch updates of tags on multiple scheduled tasks.
  • Enhancing task management and filtering in the Qinglong Panel through automated workflows.

Example: You have several scheduled tasks running scripts, and you want to tag some of them as "daily" or "critical" for easier identification and filtering later. This node operation lets you add those tags programmatically.

Properties

Name Meaning
请求Body JSON object containing two fields:
- ids: an array of scheduled task IDs (number[]) to which tags will be added.
- labels: an array of label strings (string[]) to add to the specified tasks.

Example value for 请求Body:

{
  "ids": [123, 456],
  "labels": ["daily", "backup"]
}

Output

The node outputs the JSON response from the Qinglong API under the field result inside the first input item's json property. This typically contains the API's confirmation or details about the tag addition operation.

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 an authentication token and make HTTP requests to Qinglong's REST API endpoints.
  • No additional external dependencies beyond the Qinglong API and proper credential configuration in n8n.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrectly formatted 请求Body JSON (e.g., missing ids or labels) may result in API errors.
    • Specifying non-existent task IDs will likely cause the API to return errors or ignore those IDs.

  • Error messages:

    • If the operation is not implemented or unsupported, the node throws an error indicating the operation is not yet implemented.
    • API errors returned from Qinglong are wrapped and surfaced as node errors; check the message for details.

  • Resolution tips:

    • Ensure the API key credential is correctly set up and has sufficient permissions.
    • Validate the JSON structure of the 请求Body property before execution.
    • Confirm that the task IDs exist in Qinglong before attempting to add tags.

Links and References

Discussion