青龙面板[Qinglong] icon

青龙面板[Qinglong]

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

Actions64

Overview

This node interacts with the Qinglong Panel API to manage subscriptions, specifically allowing users to update the status of one or more subscriptions. It is useful in automation workflows where subscription states need to be programmatically controlled, such as enabling, disabling, or otherwise modifying subscription statuses based on external triggers or conditions.

For example, you might use this node to batch update the status of multiple subscriptions after a certain event occurs, like a payment confirmation or a system maintenance window.

Properties

Name Meaning
请求Body JSON object containing the details for updating subscription status. It includes:
- ids: Array of subscription IDs (number[]) to update
- status: The new status to set for these subscriptions (string)
- pid: Process ID related to the update (string)
- log_path: Path to the log file (string) related to the update

The property expects a JSON structure similar to:

{
  "ids": [123, 456],
  "status": "active",
  "pid": "process_01",
  "log_path": "/var/logs/subscription.log"
}

Output

The node outputs the result of the API call under the json field of the first item in the output array, specifically:

  • result: Contains the response from the Qinglong API after attempting to update the subscription statuses. This typically includes success confirmation or error details returned by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Qinglong Panel API.
  • The node uses internal helper functions to obtain and refresh tokens needed for API requests.
  • The Qinglong Panel API endpoint must be accessible from the environment where n8n runs.

Troubleshooting

  • Common issues:

    • Invalid or expired API authentication token may cause authorization errors.
    • Incorrectly formatted JSON in the 请求Body property can lead to request failures.
    • Specifying subscription IDs that do not exist or are invalid will result in errors from the API.

  • Error messages:

    • "任务模块的...操作暂未实现" or "订阅模块的...操作暂未实现" indicate that the requested operation is not implemented in the node; ensure the correct operation name is used.
    • API errors returned from Qinglong will be included in the node's error output; check the message for details.

  • Resolution tips:

    • Verify the API credentials and permissions.
    • Validate the JSON input format carefully.
    • Confirm subscription IDs exist and are correct.
    • Check network connectivity to the Qinglong API endpoint.

Links and References

Discussion