AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node operation retrieves all MAC addresses accessible via the connected service's API. It is useful for scenarios where you need to list or audit all MAC addresses associated with your organization(s), such as network inventory management, device tracking, or security monitoring.

For example, a user might use this node to fetch all MAC addresses across multiple organizations to generate a consolidated report or to verify device compliance.

Properties

Name Meaning
Additional Query Parameters Optional parameters to refine the query:
- Organization Ids: Specify one or more organization IDs to filter results (defaults to the user's organization if not provided).
- Page: Pagination details such as page number and size to control result set size.

Output

The node outputs JSON data containing the list of MAC addresses retrieved from the API. The structure typically includes an array of MAC address objects, each representing a device's MAC address information.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authentication with the external service.
  • The node uses a base URL https://api.dnsfilter.com for its requests.
  • No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Providing invalid organization IDs in the query parameters may result in empty responses or errors.
    • Pagination parameters must be correctly formatted JSON; otherwise, the request may fail.
  • Error Messages:

    • Authentication errors typically indicate issues with the API key setup.
    • Validation errors may occur if query parameters are malformed.

To resolve these, ensure that:

  • The API key credential is correctly configured and active.
  • Organization IDs and pagination parameters are valid and properly formatted JSON objects.

Links and References

Discussion