IKAS icon

IKAS

Consume IKAS e-commerce platform API
Join our community

Actions11

Overview

This node integrates with the IKAS e-commerce platform API to manage product images by uploading them to specified product variants. It supports uploading images either from a direct URL or from Base64 encoded image data. This functionality is useful for automating product catalog updates, especially when managing multiple product variants that require consistent imagery.

Common scenarios:

  • Automatically adding or updating product images during bulk product imports.
  • Synchronizing product images from external sources or DAM systems.
  • Setting the main product image and ordering multiple images per variant.

Practical example:
You have a new product with several variants and want to upload a promotional image to all variants at once. You can use this node to select the variants, provide the image URL or Base64 data, specify the image order, and mark one as the main image.

Properties

Name Meaning
Product Variants Select one or more product variants to which the image(s) will be uploaded.
Image Source Choose the source of the image: either a URL or Base64 encoded data.
Image URL The web address of the image to upload (required if Image Source is URL).
Image Base64 The Base64 encoded string of the image data (required if Image Source is Base64).
Image Order Numeric position/order of the image among other images for the product (0 = first).
Is Main Image Boolean flag indicating whether this image should be set as the main/primary image for the product.

Output

The node outputs JSON data representing the result of the image upload operation for each input item. Each output item corresponds to an uploaded image associated with the selected product variants.

  • The json field contains details about the uploaded image, such as identifiers and status returned by the IKAS API.
  • No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the IKAS e-commerce platform.
  • The node uses IKAS GraphQL API endpoints under the base URL https://api.myikas.com/api/v1/admin.
  • Proper permissions on the API key are necessary to perform product image uploads.
  • The node depends on internal helper functions to fetch product variants dynamically for selection.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials causing authentication failures.
    • Providing an invalid image URL or malformed Base64 data leading to upload errors.
    • Selecting product variants that do not exist or are inaccessible with the current API key.
    • Network connectivity problems preventing communication with the IKAS API.

  • Error messages and resolutions:

    • "Resource "product" is not yet implemented" or "Operation "uploadImage" is not yet implemented for resource "product"": Indicates misconfiguration or unsupported operation; verify node settings.
    • Errors related to image format or size: Ensure the image URL is accessible and points to a valid image, or that Base64 data is correctly encoded.
    • Permission denied or unauthorized errors: Check API key validity and permissions.
    • If the node fails but "Continue On Fail" is enabled, error details will be included in the output JSON for troubleshooting.

Links and References

If you need further details on other operations or resources, feel free to ask!

Discussion