Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node, named "Summa," is designed to interact with the Summa API (version indicated dynamically). It supports multiple resources and operations, including a "CRUD Operator" resource with an "Update Operator" operation. The primary purpose of this node is to perform update actions on operator entities within the Summa system.

A common use case for this node is automating updates to operator records in a telecom or similar backend system where operators represent service providers or network operators. For example, you might use it to change the name of an existing operator by specifying its unique identifier and the new name.

Properties

Name Meaning
Id The unique identifier of the operator to update. This is required to specify which operator record should be modified.
Name The new name to assign to the operator. This is a required field representing the updated operator name.

Output

The node outputs JSON data representing the result of the update operation performed on the operator. This typically includes confirmation of the update, possibly the updated operator object or status information returned from the Summa API.

If the node supports binary data output, it would relate to any files or attachments returned by the API, but based on the provided code and properties, the output is primarily JSON structured data reflecting the update response.

Dependencies

  • Requires an active connection to the Summa API via an API key credential.
  • The node depends on internal helper classes for HTTP requests, state management, and operation resolution/execution.
  • The user must configure the node with valid credentials for the Summa API.
  • No additional external services beyond the Summa API are indicated.

Troubleshooting

  • Common issues:
    • Invalid or missing operator ID will cause the update to fail because the target record cannot be identified.
    • Incorrect or expired API credentials will prevent successful communication with the Summa API.
    • Network connectivity problems can cause request timeouts or failures.
  • Error messages:
    • Authentication errors typically indicate invalid API keys; verify and update credentials.
    • Validation errors may occur if required fields like "Id" or "Name" are empty or malformed.
    • API response errors should be checked for detailed messages from the Summa backend to guide corrective action.

Links and References

  • Summa API documentation (refer to your organization's internal or public API docs for detailed endpoint and data format descriptions).
  • n8n documentation on creating and using custom nodes: https://docs.n8n.io/integrations/creating-nodes/
  • General REST API usage best practices for error handling and authentication.

Discussion