mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node interacts with the "Marketplace" resource, specifically to obtain a file access token for a contributor receipt. The operation "Contributor Receipt Get File Access Token" allows users to retrieve an access token that grants permission to download or view a specific receipt file associated with a contributor.

Common scenarios include:

  • Automating retrieval of receipt files for contributors in a marketplace environment.
  • Integrating receipt access into workflows for accounting, auditing, or record-keeping.
  • Providing secure, token-based access to contributor receipts without exposing direct file URLs.

Example use case: A marketplace administrator wants to automatically fetch access tokens for contributor receipts to embed secure download links in notification emails.

Properties

Name Meaning
Contributor Id The unique identifier of the contributor whose receipt file access token is requested.
Contributor Receipt Id The unique identifier of the specific contributor receipt for which the access token is needed.

Output

The node outputs JSON data containing the file access token related to the specified contributor receipt. This token can be used to securely access or download the receipt file.

If the node supports binary data output (not explicitly shown in the provided code), it would typically represent the actual receipt file content or a downloadable stream. However, based on the static analysis, the primary output is a JSON object with the access token information.

Dependencies

  • Requires an API key credential for authentication with the mittwald mStudio API.
  • Connects to the mittwald API endpoint at https://api.mittwald.de.
  • Uses the OpenAPI specification defined in the bundled openapi.json for request construction.

Troubleshooting

  • Missing or invalid Contributor Id / Contributor Receipt Id: Ensure both IDs are correctly provided and correspond to existing records in the marketplace system.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions to access contributor receipt data.
  • Network or API errors: Check connectivity to the mittwald API endpoint and confirm the service status.
  • Unexpected response format: Confirm that the API version matches the expected OpenAPI schema used by the node.

Links and References

Discussion