Surprise Dev

🎪 Magic node for creating surprise workflows with universal instance support

Surprise Dev

AI-generated

Overview

The Surprise Dev node is a versatile transformation node designed to interact with a user's instance via an API key, supporting optional Basic Authentication and a secret code for enhanced features. It is useful for creating surprise workflows that require universal instance support, such as automating tasks or integrating with custom APIs. The node validates essential inputs like instance URL and API key, constructs a request with authentication headers, and sends data to a remote webhook endpoint, returning the response enriched with metadata about the execution context.

Use Case Examples

  1. Automate workflow triggers based on weekly data by specifying a week number or letting the node calculate it automatically.
  2. Use the node to connect to a private API endpoint with Basic Authentication by providing username and password.
  3. Unlock hidden features in your workflow by supplying a secret code, enhancing the node's capabilities.

Properties

Name Meaning
Authentication Method Selects the authentication method to use for the API request, either none or Basic Authentication.
Username Username for Basic Authentication, required if Basic Auth is selected.
Password Password for Basic Authentication, required if Basic Auth is selected.
Your Instance URL The URL of the user's instance where the API key was created; used as the base URL for requests.
User API Key The personal API key from the user's settings, required for authentication.
Secret Code An optional special code to unlock hidden features in the node.
Week Number The week number to use in the request; 0 triggers automatic calculation based on the current date.

Output

JSON

  • success - Indicates if the request was successful.
  • error - Error message if the request failed.
  • instructions - Step-by-step instructions to resolve common input errors.
  • donation_info - Information about supporting the development of the node.
  • magic_execution
    • node_version - Version of the node used during execution.
    • user_instance - The instance URL used in the request.
    • timestamp - Timestamp of the execution.
    • authentication_method - Authentication method used in the request.
    • secret_code_used - Indicates if a secret code was provided.
    • week_number - Week number used in the request.
    • magic_level - Level of magic based on secret code usage (enhanced or standard).
    • surprise_factor - A fixed string indicating maximum surprise factor.
    • universal_compatibility - Boolean indicating universal compatibility.

Dependencies

Troubleshooting

  • Ensure the instance URL is provided, correctly formatted, and does not include trailing slashes or API paths.
  • Verify the API key is valid and has the necessary permissions.
  • If Basic Authentication is selected, provide both username and password; otherwise, switch to 'None' authentication.
  • Check internet connectivity if requests fail.
  • Error messages provide guidance on missing or invalid inputs and suggest corrective steps.

Links

Discussion