Commanders ActInstall

Overview

This node integrates with the Commanders Act API, specifically supporting various resources and operations related to data governance, privacy, and analytics management. For the Cookie Scanner resource with the List Generated Versions operation, it retrieves a list of all generated versions of cookie scanner configurations or snapshots.

This functionality is useful for users who want to audit, review, or manage different versions of their cookie scanner setups over time. For example, a compliance officer might use this node to fetch all generated versions to verify which cookie consent configurations were active at specific times.

Properties

The full list of query parameter options includes:

• End
• Fields[template]
• Filter (JSON object)
• Filter[begin_date]
• Filter[end_date]
• Filter[from]
• Filter[rangeType]
• Filter[search]
• Filter[segment_id]
• Filter[sup_filters][device][]
• Filter[sup_filters][location][]
• Filter[to]
• Filter[types]
• Granularity
• Include
• Page (JSON)
• Sort (JSON or string depending on context)
• Source
• Start
• Token (password type)

Output

The output is an array of JSON objects representing the generated versions retrieved from the Commanders Act API under the cookie scanner resource. Each item corresponds to one generated version with its associated metadata as returned by the API.

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, it outputs a status code message "204 No Content".

No binary data output is involved in this operation.

Dependencies

• Requires an API key credential for authenticating with the Commanders Act API.
• The base URL used is https://api.commander1.com/v2.
• The node expects valid credentials containing a site ID and an API token.
• Proper configuration of these credentials in n8n is necessary before using the node.

Troubleshooting

• Missing Credentials Error: If the API credentials are not set or invalid, the node throws an error indicating missing credentials. Ensure that the API key and site ID are correctly configured.
• Required Parameter Missing: For this operation, no mandatory path parameters are required, but if you select other operations or resources, missing IDs (like Cookie ID) will cause errors.
• API Request Errors: Network issues, invalid query parameters, or API limits may cause errors. The node surfaces these as API errors with messages and stack traces.
• Parsing Errors: If the API returns malformed JSON, the node will output raw text instead of JSON, which might require manual handling downstream.

Links and References

• Commanders Act API Documentation (general reference for API endpoints and parameters)
• n8n Documentation - Creating Custom Nodes
• Commanders Act Cookie Scanner Overview (for understanding cookie scanner concepts and versions)

This summary focuses exclusively on the Cookie Scanner resource and the List Generated Versions operation as requested.