Commanders Act icon

Commanders Act

Use the Commanders Act API

Actions108

Overview

This node integrates with the Commanders Act API, specifically supporting various resources and operations related to data management and privacy compliance. The "Cookie Scanner" resource with the "List Cookies" operation allows users to retrieve a list of cookies managed by the Commanders Act platform.

This node is beneficial for organizations that need to automate the retrieval and management of cookie information for compliance with privacy regulations such as GDPR or CCPA. For example, it can be used to fetch all cookies detected on a website to audit their usage or to integrate cookie data into other systems for reporting or consent management.

Properties

Name Meaning
Query Parameters A collection of optional parameters to filter, sort, paginate, or specify details in the cookie list request. Options include: End, Fields[template], Filter (with subfields like begin_date, end_date, search, segment_id, device, location, types), Granularity, Include, Page, Sort, Source, Start, Token (API token).

The "Query Parameters" property supports many specific keys allowing fine-grained control over the listing of cookies, such as filtering by date ranges, device types, locations, sorting options, pagination, and more.

Output

The output is a JSON array where each element corresponds to the response from the Commanders Act API for the requested operation. For the "List Cookies" operation, the output JSON contains the list of cookies matching the query parameters.

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 produced by 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 within n8n is necessary.
  • The user must provide the site ID and API token via credentials or input parameters.

Troubleshooting

  • Missing Credentials: The node throws an error if the required API credentials are not provided. Ensure the API key and site ID are configured correctly.
  • Required Parameter Missing: For some operations, certain IDs or parameters are mandatory. For example, the "List Cookies" operation requires no mandatory ID but uses query parameters optionally. Other operations may require cookie IDs or version IDs.
  • API Errors: If the API call fails, the node throws an error with the message from the API. Check the API token validity, network connectivity, and parameter correctness.
  • Parsing Errors: If the API returns non-JSON text unexpectedly, the node outputs raw text. Verify the API response format and parameters.

Links and References


This summary focuses on the "Cookie Scanner" resource and the "List Cookies" operation as requested.

Discussion