bookoly icon

bookoly

Interact with the bookoly API

Overview

This node integrates with the Bookoly API to perform various video processing operations, including rotating a video. Specifically, the "Rotate a Video" operation allows users to rotate a given video file by a specified angle (90°, 180°, or 270° degrees). This is useful in scenarios where videos need orientation correction or creative rotation effects.

Practical examples:

  • Correcting a video recorded in portrait mode that needs to be displayed in landscape.
  • Rotating security camera footage for proper viewing.
  • Creating artistic video content by rotating clips.

The node supports waiting for the video processing to complete before continuing the workflow or returning immediately with minimal information and optionally sending webhook notifications when processing finishes.

Properties

Name Meaning
Name The name to assign to the processed video.
Video URL The publicly accessible and downloadable URL of the source video file to be rotated.
Mute Video Whether to mute the original audio track of the video during processing (true/false).
Rotation (Degrees) The angle to rotate the video. Options: 90 (clockwise), 180, or 270 degrees clockwise rotation.
Wait for Completion If true, the node waits until the video processing completes and returns the full video object; if false, returns only ID and timestamp.
Webhook URL Optional URL to receive webhook notifications about the video processing status, including video ID and URL.

Output

The node outputs JSON data representing the processed video object returned from the Bookoly API. When "Wait for Completion" is enabled, this includes detailed metadata about the completed video. If disabled, the output contains only the video ID and creation timestamp.

If the node supports binary data output (not explicitly shown here), it would typically represent the processed video file itself or related media assets.

Dependencies

  • Requires an active connection to the Bookoly API via an API key credential configured in n8n.
  • Internet access to download the source video from the provided public URL.
  • Optionally, a webhook endpoint to receive asynchronous notifications about video processing status.

Troubleshooting

  • Common issues:

    • Invalid or inaccessible video URL: Ensure the URL is publicly accessible and points directly to a downloadable video file.
    • API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
    • Timeout or long processing times: Large videos may take longer to process; consider enabling webhook notifications instead of waiting synchronously.
    • Incorrect rotation values: Only 90, 180, or 270 degrees are supported; other values will cause errors.
  • Error messages:

    • No handler found for video.rotateVideo: Indicates misconfiguration or missing implementation for the rotate operation.
    • Failed to execute rotateVideo: <message>: General failure during API call or processing; check message details for specifics.

Resolving these usually involves verifying input parameters, credentials, and network connectivity.

Links and References

Discussion