青龙面板[Qinglong] icon

青龙面板[Qinglong]

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

Overview

This node integrates with the Qinglong Panel API, a task scheduling and management platform. It allows users to perform various system-level operations such as sending notifications, managing scheduled tasks (crontabs), subscriptions, environment variables, configurations, scripts, dependencies, logs, and system commands.

Specifically, for the 系统设置 (System Settings) resource with the 发送通知 (Send Notification) operation, the node sends a notification message to the Qinglong system. This is useful for alerting or informing users about important events or statuses within their Qinglong environment.

Practical example:
You can use this node to send a custom notification with a title and content to your Qinglong panel whenever a critical workflow finishes or an error occurs, helping you stay informed in real-time.

Properties

Name Meaning
请求Body JSON object containing the notification details. It must include:
- title: The notification title (string, required)
- content: The notification content/message (string, required)

Example of the 请求Body property value:

{
  "title": "通知标题(必填):string",
  "content": "通知内容(必填):string"
}

Output

The node outputs the result of the API call in the json field under the key result. This contains the response from the Qinglong API after attempting to send the notification.

The output structure is:

{
  "result": { /* API response object */ }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to access the Qinglong API.
  • The node calls the Qinglong API endpoint /open/system/notify using HTTP PUT method.
  • Proper network access to the Qinglong API server is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrectly formatted JSON in the 请求Body property may lead to request errors.
    • Network connectivity problems to the Qinglong API server will prevent successful requests.
  • 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 surfaced as node errors; check the API response for details.
  • Resolution tips:

    • Ensure the API key credential is correctly set up and has sufficient permissions.
    • Validate the JSON body format before execution.
    • Verify the Qinglong API URL and network accessibility.

Links and References

Discussion