Infomaniak CoreResources icon

Infomaniak CoreResources

Interact with Infomaniak API

Overview

This node interacts with the Infomaniak API to retrieve multiple timezones ("Get Many" operation under the "Timezone" resource). It allows users to fetch a list of available timezones with various filtering, sorting, and pagination options. This is useful in scenarios where workflows need to handle or display timezone data, such as scheduling events, converting times, or configuring user preferences based on geographic location.

Practical examples:

  • Fetching all timezones to populate a dropdown menu for user selection.
  • Searching for specific timezones by name or partial match.
  • Retrieving a limited number of timezones sorted by a particular field for reporting or display purposes.

Properties

Name Meaning
Return All Boolean flag to return all matching timezones or limit the results to a specified number.
Limit Maximum number of timezones to return if "Return All" is false.
Additional Options A collection of optional parameters to refine the query:
- Search Text filter to search timezones by name or other attributes.
- Return Option to specify what to return; currently supports "Total" to get total count only.
- Skip Number of items to skip (offset) for pagination.
- Page Page number for paginated results.
- Per Page Number of items per page when paginating.
- Order By Field name to order the results by.
- Order Direction of ordering: Ascending or Descending.
- Order For JSON object defining custom sorting orders for fields.

Output

The output is a JSON array containing timezone objects retrieved from the Infomaniak API. Each object represents a timezone with its associated properties as provided by the API. The exact structure depends on the API response but typically includes identifiers, names, offsets, and other relevant timezone metadata.

No binary data output is produced by this operation.

Dependencies

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

Troubleshooting

  • Invalid JSON format for "Order For" parameter: If the "Order For" option contains invalid JSON, the node will throw an error. Ensure that the JSON string is correctly formatted.
  • Failed to retrieve timezones: This error occurs if the API request fails or returns an unsuccessful result. Check the API token validity, network connectivity, and API service status.
  • Limit and Return All conflict: If "Return All" is false but no valid limit is set, the node defaults to 50 items. Adjust these settings to control the volume of data returned.
  • API rate limits or authorization errors: Ensure the API key has sufficient permissions and is not expired or revoked.

Links and References


This summary covers the "Timezone" resource with the "Get Many" operation specifically, reflecting the input properties and logic extracted from the provided source code.

Discussion