AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node operation retrieves a list (index) of API keys from an external service. It allows filtering the results by various optional query parameters such as whether the key is expired, its ID, last four characters of the token, name, or associated organization ID. This functionality is useful for managing and auditing API keys programmatically, for example, to monitor active keys, identify expired ones, or find keys related to specific organizations.

Practical examples include:

  • Fetching all expired API keys to clean up or revoke them.
  • Searching for an API key by its last four digits for verification.
  • Listing all API keys belonging to a particular organization.

Properties

Name Meaning
Additional Query Parameters Optional filters to narrow down the API key list. Possible fields:
- Expired: boolean indicating if the API key is expired or not.
- Id: numeric ID of the API key.
- Last Four: string representing the last four characters of the API key token.
- Name: string name of the API key.
- Organization Id: numeric ID of the organization associated with the API key.

Output

The node outputs JSON data containing the list of API keys matching the query parameters. Each item in the output typically includes details about an API key such as its ID, name, expiration status, last four characters of the token, and associated organization ID. The exact structure depends on the external API's response schema.

No binary data output is indicated.

Dependencies

  • Requires an API key credential to authenticate requests to the external API service.
  • The base URL for the API requests is set to https://api.dnsfilter.com.
  • The node uses standard HTTP headers for JSON content (Accept and Content-Type).

Troubleshooting

  • Common issues:

    • Authentication failures due to missing or invalid API credentials.
    • Incorrect query parameter values causing no results or errors.
    • Network connectivity problems preventing access to the API endpoint.
  • Error messages:

    • Unauthorized or 401 errors indicate invalid or missing API authentication.
    • 400 Bad Request errors may result from invalid query parameters; verify parameter types and values.
    • Timeout or network errors suggest connectivity issues; check internet connection and API availability.

Links and References

Discussion