Commanders ActInstall

Overview

This node integrates with the Commanders Act API, specifically enabling management of various resources including the Cookie Scanner. The "Deploy Cookie Notice" operation under the Cookie Scanner resource allows users to deploy a cookie notice version to their website. This is useful for website administrators or compliance officers who need to update or activate cookie consent notices on their sites to comply with privacy regulations such as GDPR.

Practical example:

• After creating or updating a cookie notice version in Commanders Act, you can use this node operation to deploy that specific version live on your website, ensuring visitors see the updated cookie consent banner.

Properties

The "Query Parameters" collection supports multiple optional fields such as:

• end: End date/time filter.
• filter: JSON object for complex filtering.
• page: JSON for pagination.
• sort: JSON or string to specify sorting.
• token: An optional API token (password type).
• Other filters related to device, location, segment, etc.

Output

The output is a JSON array where each element corresponds to the response from the Commanders Act API for the deployment request. The structure depends on the API response but typically includes status information about the deployment action.

If the API returns a string response, the node attempts to parse it as JSON; if parsing fails, it outputs the raw text. If no content is returned (HTTP 204), the node outputs an object indicating "204 No Content".

No binary data output is involved in this operation.

Dependencies

• Requires an API key credential for Commanders Act API authentication.
• The node uses the base URL https://api.commander1.com/v2.
• Proper configuration of the API credentials in n8n is necessary before using this node.

Troubleshooting

• Missing Required Parameters: The node throws errors if mandatory parameters like "Cookie Notice Version ID" are not provided. Ensure all required inputs are set.
• Authentication Errors: If API credentials are missing or invalid, the node will throw an error indicating missing credentials.
• API Request Failures: Network issues or incorrect parameters may cause API call failures. The node surfaces these errors with messages prefixed by "Error calling Commanders Act API".
• Parsing Errors: If the API returns unexpected non-JSON responses, the node tries to handle them gracefully but may output raw text instead of structured JSON.

To resolve errors:

• Verify all required input properties are correctly filled.
• Confirm API credentials are valid and have sufficient permissions.
• Check network connectivity and API endpoint availability.
• Review the API documentation for correct parameter usage.

Links and References

• Commanders Act Official API Documentation (for detailed API endpoints and parameters)
• GDPR Compliance and Cookie Notices
• n8n Documentation on Creating Custom Nodes

This summary focuses exclusively on the "Deploy Cookie Notice" operation within the "Cookie Scanner" resource as requested.