mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node interacts with the mittwald mStudio API to retrieve the base item associated with a specific Contract. It is useful when you need to fetch detailed information about the foundational element or resource that a given contract references. For example, in scenarios where contracts are linked to particular services, products, or resources, this node helps extract the underlying base item data for further processing or integration.

Properties

Name Meaning
Contract Id The UUID of the Contract from which the BaseItem is to be issued. This is a required string.

Output

The node outputs JSON data representing the base item related to the specified contract. The structure of this JSON corresponds to the base item details as provided by the mittwald mStudio API. This typically includes all relevant fields describing the base item entity.

If the API supports binary data for the base item (e.g., attachments or files), the node would handle it accordingly, but based on the provided code and description, the output is primarily JSON.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de for API requests.
  • The node depends on the @devlikeapro/n8n-openapi-node package for building properties and handling OpenAPI specifications.

Troubleshooting

  • Invalid Contract Id: If the provided Contract Id is incorrect or does not exist, the API may return an error or empty response. Verify the UUID format and existence of the contract.
  • Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Network Issues: Connectivity problems to https://api.mittwald.de can cause request failures.
  • Unexpected Response Structure: If the API changes its response format, the node might not parse the output correctly. Check for updates in the API documentation or node version.

Links and References

Discussion