Commanders Act icon

Commanders Act

Use the Commanders Act API

Actions108

Overview

This node integrates with the Commanders Act API, specifically enabling management of the Cookie Scanner resource. The "Create Cookie" operation allows users to create a new cookie entry within the Commanders Act platform's cookie scanner module. This is useful for organizations that need to manage and track cookies used on their websites for compliance and privacy purposes.

Typical use cases include:

  • Adding new cookies detected on a website to the Commanders Act cookie scanner database.
  • Automating cookie management workflows as part of broader data privacy or consent management processes.
  • Integrating cookie creation into larger automation flows that handle website compliance audits.

For example, a marketing team could automatically add newly discovered cookies from their web analytics tools into the Commanders Act system to keep their cookie inventory up to date.

Properties

Name Meaning
Query Parameters Optional URL query parameters to customize the API request. Includes options such as end, filter (with subfields like begin_date, end_date, search), granularity, include, page, sort, source, start, and a password-protected token.
Request Body JSON object representing the body of the POST request to create the cookie. This should contain the cookie details as required by the Commanders Act API.

The "Query Parameters" collection allows fine-tuning of the API call with various filters and pagination controls, though for creating a cookie, these are typically less relevant than for listing or querying resources.

Output

The node outputs an array of JSON objects representing the response from the Commanders Act API after attempting to create the cookie. The structure depends on the API response but generally includes the created cookie's details or error information if the creation failed.

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), it outputs a status message indicating "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 node uses the base URL https://api.commander1.com/v2.
  • Proper configuration of the API credentials in n8n is necessary before using this node.
  • The user must provide valid JSON in the "Request Body" property matching the expected schema for creating a cookie in the Commanders Act system.

Troubleshooting

  • Missing Credentials: The node will throw an error if the API credentials are not set or invalid. Ensure the API key/token is correctly configured.
  • Required Fields Missing: If mandatory parameters like cookie identifiers or version IDs are missing when required, the node throws descriptive errors (e.g., "Cookie ID is required").
  • Invalid JSON in Request Body: The request body must be valid JSON. Malformed JSON will cause the API call to fail.
  • API Errors: Any errors returned by the Commanders Act API are wrapped and presented with messages prefixed by "Error calling Commanders Act API". Check the API documentation and ensure all required fields and formats are correct.
  • Network Issues: Connectivity problems to the API endpoint will result in request failures. Verify network access and proxy settings if applicable.

Links and References


This summary is based solely on static analysis of the provided source code and input property definitions. It does not execute or simulate runtime behavior.

Discussion