JetNet Tool icon

JetNet Tool

Access JetNet aviation data for AI Agents

Overview

The "JetNet Tool" node provides access to comprehensive aviation industry data from the JetNet database. It supports multiple resources such as Aircraft, Company, Contact, and Market data, with various operations for each resource. Specifically, the Aircraft - Get History List operation retrieves a list of historical records related to an aircraft, which can include ownership changes, transactions, or other significant events in the aircraft's lifecycle.

This node is beneficial for users who need detailed aviation data for analysis, reporting, or integration into aviation-related workflows. For example, aircraft brokers, maintenance providers, or market analysts can use this node to fetch historical data about specific aircraft to assess value, verify ownership history, or track maintenance and event records.

Properties

Name Meaning
Tool Description Choose how to set the tool description:
- Set Automatically: The description is auto-generated based on the selected resource and operation.
- Set Manually: Allows manual input of a custom description explaining what the tool does.
Description A text field to manually describe the tool’s purpose. This helps language models better understand the tool’s function when set manually. Default is a general description of accessing JetNet aviation data.

Note: The above properties are generic for the entire JetNet Tool node. For the Aircraft - Get History List operation, no additional input parameters are explicitly defined in the provided snippet, but the API call expects parameters passed as JSON in the request body (e.g., filters or pagination options).

Output

The node outputs a JSON string containing:

  • success: Boolean indicating if the API call was successful.
  • resource: The resource type used ("aircraft").
  • operation: The operation performed ("getHistoryList").
  • data: The actual response data from the JetNet API, which includes the aircraft history list details.
  • timestamp: ISO timestamp of when the response was generated.

Example output structure (formatted for clarity):

{
  "success": true,
  "resource": "aircraft",
  "operation": "getHistoryList",
  "data": {
    /* Aircraft history list data returned by JetNet API */
  },
  "timestamp": "2024-06-XXTXX:XX:XX.XXXZ"
}

The data field contains the detailed history list for the specified aircraft, including transaction records, event dates, descriptions, and other relevant historical information.

The node does not output binary data.

Dependencies

  • Requires an active connection to the JetNet API service.
  • Requires an API authentication token and bearer token credential configured in n8n to authorize requests to JetNet.
  • The base URL for API requests is https://customer.jetnetconnect.com.
  • The node uses HTTP GET or POST methods depending on the operation specifics.

Troubleshooting

  • Missing Required IDs:
    For many aircraft operations, including history list retrieval, the node expects certain identifiers (like aircraftId) or parameters. If these are missing, the node will throw errors such as:
    "Aircraft ID is required for this operation"
    Ensure that the correct aircraft identifier is provided in the input parameters.

  • Invalid Registration Number:
    When using operations like "Get by Registration," if the registration number format is invalid or missing, an error will be thrown. Validate the registration number before execution.

  • Unknown Operation or Resource:
    Errors like "Unknown aircraft operation: getHistoryList" or "Unknown resource: xyz" indicate unsupported or misspelled resource/operation names. Verify the exact spelling and availability of the operation.

  • API Authentication Errors:
    If credentials are incorrect or expired, API calls will fail. Confirm that the API key and bearer token are valid and properly configured in n8n.

  • Network or API Endpoint Issues:
    Network failures or JetNet service downtime may cause request failures. Check network connectivity and JetNet service status.

Links and References

  • JetNet Official Website – For more information about the JetNet aviation data services.
  • JetNet API documentation (not publicly included here) – Consult your JetNet account representative for API endpoint details and usage guidelines.
  • n8n Documentation – For configuring credentials and using custom nodes.

This summary focuses on the Aircraft - Get History List operation within the JetNet Tool node, describing its purpose, inputs, outputs, dependencies, and common troubleshooting tips.

Discussion