Example Node

Basic Example Node

Overview

This node performs a simple HTTP GET request to an external public API that provides company information based on a given identifier string. For each input item, it takes a string parameter, queries the API endpoint with this string, and returns the JSON response from the API. This node is useful for enriching data workflows with company details fetched dynamically from an external source.

Practical examples include:

  • Enriching a list of company identifiers with detailed company data.
  • Validating or verifying company information during data processing.
  • Integrating external business data into automation workflows.

Properties

Name Meaning
My String The description text; a string input used as the identifier to query the external API. Placeholder shown as "Placeholder value".

Output

The node outputs an array of JSON objects, each corresponding to one input item. Each output JSON contains the full response from the external API for the provided string identifier.

If an error occurs during the API request and the node is configured to continue on failure, the output JSON for that item will contain an error field with the error message.

No binary data is produced by this node.

Dependencies

  • Requires internet access to call the external API at https://publica.cnpj.ws/cnpj/{identifier}.
  • No internal credentials are required; the API appears to be publicly accessible without authentication.
  • Uses standard HTTP GET requests with JSON responses.

Troubleshooting

  • Common issues:

    • Network connectivity problems may cause request failures.
    • Invalid or malformed input strings may result in API errors or empty responses.
    • Rate limiting or downtime of the external API could cause errors.

  • Error messages:

    • If the API request fails, the node throws an error unless configured to continue on failure.
    • When continuing on failure, errors are returned in the output JSON under the error key, containing the error message.

  • Resolutions:

    • Verify the input string format matches expected API requirements.
    • Ensure stable internet connection.
    • Use the node's "Continue On Fail" option to handle intermittent API errors gracefully.

Links and References

Discussion