Infomaniak CoreResources icon

Infomaniak CoreResources

Interact with Infomaniak API

Actions28

Overview

This node interacts with the Infomaniak API to retrieve multiple products based on various filter criteria. It is designed to fetch a list of products where the user has rights, supporting filtering, sorting, pagination, and additional data loading options.

Common scenarios for this node include:

  • Retrieving all products associated with a specific account or customer.
  • Filtering products by service type or product identifiers.
  • Paginating through large sets of products.
  • Sorting products by different fields in ascending or descending order.
  • Fetching additional related resource data about products.

Practical example:

  • A user wants to get all "Web Hosting" products linked to a particular account ID, sorted by internal name, and load extra details about each product. This node can be configured with filters for account ID, service name set to "web_hosting", order by "internalName", and specify additional options to load related data.

Properties

Name Meaning
Product Filters Collection of filters to narrow down the products returned. Options include:
- Account ID (number): Filter by account identifier.
- Customer Name (string): Filter by customer name.
- FQDN (string): Filter by fully qualified domain name.
- Internal Name (string): Filter by internal name.
- Product ID (number): Filter by product identifier.
- Service ID (options): Filter by service ID (e.g., 1, 2, 3, ...).
- Service Name (options): Filter by service name (e.g., AI Tools, Backup, Web Hosting, etc.).
Return All Boolean flag indicating whether to return all matching results or limit the number of results.
Limit Number specifying the maximum number of results to return if "Return All" is false. Minimum value is 1.
Additional Options Collection of optional parameters:
- With (string): Load additional data about resources.
- Order By (string): Field used for sorting.
- Order Direction (options): Sort order direction ("Ascending" or "Descending").
- Page (number): Page number for pagination.
- Per Page (number): Number of results per page.
- Skip (number): Number of items to skip.
- Return Total Count (boolean): Return only the total count instead of items.

Output

The output is an array of JSON objects representing the products retrieved from the Infomaniak API. Each object contains product details as provided by the API, which may include identifiers, names, service information, and other metadata depending on the filters and additional options used.

If the "Return Total Count" option is enabled, the output will contain only the total count of matching products instead of the product items themselves.

The node does not output binary data.

Dependencies

  • Requires an API authentication token credential for the Infomaniak API.
  • The node makes HTTP GET requests to the Infomaniak API endpoint https://api.infomaniak.com/1/products.
  • Proper configuration of the API key credential in n8n is necessary for successful requests.

Troubleshooting

  • Failed to retrieve products: This error occurs if the API request fails or returns an unexpected result. Check that the API token is valid and has sufficient permissions.
  • Invalid filter values: Ensure numeric filters like Account ID, Product ID, and Service ID are numbers and within valid ranges.
  • Pagination issues: If using pagination options (Page, Per Page, Skip), verify that values are positive integers.
  • Return Total Count without items: When enabling "Return Total Count," no product items will be returned, only the count. Make sure this behavior matches your use case.
  • API rate limits or network errors: Network connectivity or API rate limiting might cause failures. Retry or check API usage limits.

Links and References

Discussion