Overview
This node integrates with the Contentdrips API to create and manage visual content such as static graphics and multi-slide carousels. It supports generating new graphics or carousels from templates, checking the status of asynchronous processing jobs, and retrieving the results of completed jobs.
Common scenarios where this node is beneficial include automating social media content creation, marketing material generation, or any workflow requiring dynamic graphic generation based on templates. For example, a user can generate a branded carousel post with custom text and images, then poll the job status until the rendering completes, and finally retrieve the finished graphic for further use or distribution.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform: - Generate Graphic: Create a static graphic from a template - Generate Carousel: Create a multi-slide carousel - Check Job Status: Check the status of a processing job - Get Job Result: Retrieve the result of a completed job |
| Template ID | The ID of the template used for rendering (required for graphic and carousel generation) |
| Output Format | The output file format for generated content: PNG or PDF |
| Include Branding | Whether to include branding information in the output |
| Branding | Collection of branding details (shown if Include Branding is true): name, handle, bio, website URL, avatar image URL |
| Content Updates | List of updates to content elements within the template; each update specifies type (text box or image), label, and value |
| Intro Slide | Details for an optional intro slide in a carousel: heading, description, image URL |
| Slides | Multiple slides for a carousel; each slide includes heading, description, and image URL |
| Ending Slide | Details for an optional ending slide in a carousel: heading, description, image URL |
| Job ID | The ID of the job to check status or retrieve results for (required for "Check Job Status" and "Get Job Result" operations) |
Output
The node outputs JSON data representing the response from the Contentdrips API for the selected operation:
- For Generate Graphic and Generate Carousel, the output contains details about the submitted rendering job, including job identifiers and metadata.
- For Check Job Status, the output provides the current status of the specified job (e.g., pending, processing, completed).
- For Get Job Result, the output includes the final rendered content or links to download it.
If the API returns binary data (such as image files), it would typically be handled via URLs or base64 encoded data in the JSON response rather than direct binary output.
Dependencies
- Requires an API key credential for authenticating with the Contentdrips API.
- The node uses HTTP requests to communicate with the Contentdrips service endpoints.
- No additional external dependencies beyond the configured API authentication are needed.
Troubleshooting
- Invalid Job ID: If the provided Job ID does not exist or is malformed, the API may return an error. Verify the Job ID is correct and corresponds to a previously submitted job.
- API Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
- Template ID Issues: For generation operations, providing an invalid or missing Template ID will cause failures. Confirm the template exists and the ID is accurate.
- Network or Timeout Errors: Network connectivity issues or slow responses from the Contentdrips API can cause timeouts. Retry or check network settings.
- Unknown Operation Error: This occurs if an unsupported operation is selected. Use one of the defined operations only.
Links and References
- Contentdrips API Documentation (example link, replace with actual)
- n8n Documentation on Creating Custom Nodes
- General info on Handling Asynchronous Jobs in APIs