Eskom icon

Eskom

Consume Eskom API (v.0.1.2)

Overview

The Eskom node for n8n allows users to interact with the Eskom API, specifically to retrieve topics (likely related to power or energy) that are geographically nearby a specified latitude and longitude. This is useful in scenarios where you want to find relevant Eskom topics or data points close to a particular location—such as for mapping, alerting, or localized reporting.

Practical examples:

  • Displaying Eskom-related topics near a user's current GPS location.
  • Integrating with mapping tools to show nearby Eskom service areas or issues.
  • Automating notifications about Eskom topics relevant to a specific geographic area.

Properties

Name Type Meaning
Latitude Number The latitude coordinate used to search for nearby topics.
Longitude Number The longitude coordinate used to search for nearby topics.
Simplify Boolean If enabled, the output will be simplified for easier consumption in downstream nodes.

Output

  • The node outputs a json field containing the list of topics found near the provided latitude and longitude.
  • If "Simplify" is enabled, the structure may be flattened or made more concise.
  • The exact structure depends on the Eskom API response, but typically includes topic details such as name, id, and possibly distance from the queried coordinates.

Dependencies

  • External Service: Requires access to the Eskom API.
  • API Key: You must configure valid Eskom API credentials in n8n under the credential type eskomApi.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the Eskom API key is missing or incorrect, authentication errors will occur. Ensure your credentials are set up correctly in n8n.
  • Missing Coordinates: Both latitude and longitude must be provided; otherwise, the node may return an error or empty results.
  • API Rate Limits: Exceeding Eskom API usage limits may result in errors or throttling.

Error Messages & Resolutions:

  • "Authentication failed": Check and update your Eskom API credentials.
  • "Missing required parameter: lat/lon": Ensure both Latitude and Longitude fields are filled.
  • "API allowance exceeded": Wait before making further requests or check your Eskom API plan.

Links and References

Discussion