AdBlast icon

AdBlast

Interact with AdBlast API

Actions56

Overview

This node integrates with the AdBlast API to finalize the upload of a visual sound asset associated with a specific scene in a project. It is designed to confirm and complete the upload process by sending necessary identifiers and URLs obtained from a prior upload step (such as an S3M finalize response). This operation is useful in workflows where visual sound elements are prepared and uploaded separately, and then need to be finalized within the AdBlast system for further processing or deployment.

Practical examples include:

  • Finalizing the upload of audio-visual assets after they have been stored on a cloud storage service.
  • Automating the completion of media uploads in a content production pipeline.
  • Integrating with AdBlast to manage project scenes and their associated visual sound components programmatically.

Properties

Name Meaning
Authentication Method Choose between using saved API credentials or entering an API key dynamically via expressions.
AdBlast Base URL The base URL for the AdBlast API; required if using dynamic API key authentication.
API Key The API key for authenticating requests; used when dynamic API key authentication is selected.
Project Id The unique identifier of the project to which the visual sound belongs.
Scene Id The identifier of the scene within the project.
Visual Id The identifier of the visual element related to the sound upload.
Uuid The upload UUID returned from the S3M finalize response, used to identify the upload session.
Cdn Url The CDN URL provided by the S3M finalize response, pointing to the uploaded asset location.
Path The relative path from the S3M finalize response indicating the asset's location in storage.

Output

The node outputs JSON data representing the response from the AdBlast API after finalizing the visual sound upload. This typically includes confirmation details about the finalized upload, such as status, identifiers, or metadata related to the visual sound asset.

If binary data were involved, it would represent the actual media content or related files, but this node focuses on finalization metadata rather than transferring binary data itself.

Dependencies

  • Requires access to the AdBlast API, which necessitates either saved API credentials or a dynamically provided API key.
  • The node expects prior steps to provide upload-related data such as UUID, CDN URL, and path, typically from an S3M finalize response or equivalent.
  • Network connectivity to the specified AdBlast Base URL is essential.
  • Proper configuration of authentication method and API keys within n8n is required.

Troubleshooting

  • Authentication errors: Ensure that the API key or saved credentials are valid and have sufficient permissions to finalize uploads.
  • Invalid or missing parameters: Verify that all required fields (Project Id, Scene Id, Visual Id, Uuid, Cdn Url, Path) are correctly set and correspond to existing resources in AdBlast.
  • Network issues: Confirm that the AdBlast Base URL is reachable from the n8n environment and that no firewall or proxy blocks the request.
  • Incorrect upload UUID or CDN URL: These must come from a successful prior upload step; mismatches will cause the finalization to fail.
  • If the node returns error messages from the API, consult the AdBlast API documentation for specific error codes and remedies.

Links and References

Discussion