search
Support

Data Format for Custom Data Feed

hashtag
Overview

The following section details the standard data input format that is expected by the Upload service. It also explains how these files should be transmitted to Fredhopper's Managed Services environment and for the data to be triggered on the instance. Once the additional data has been successfully uploaded and processed, it will be integrated with the next product feed update (full or incremental). The same custom data will be maintained for all subsequent load-data triggers until a new version of the custom data is uploaded using this process.

hashtag
Uploading and Triggering the processing of data using Upload

Once the custom file(s) is ready in the predefined format, it then needs to be compressed using the zip archive specification (application/zip) before it can be uploaded. An MD5 checksum of the newly created ZIP file also needs to be generated to verify the file.

Fredhopper offers a REST and File (FTP) API. The File (FTP) API is suitable for development purposes, while for production use we strongly recommend the use of the REST API.

Region
Countries
Data Endpoint

EU

All

https://my.eu1.fredhopperservices.com/uploadarrow-up-right:[service_instance]/data/input/

The service_instance is either live1, test1, test2 or test3, depending on the environments that are available for you.

hashtag
Steps

  1. Compress the data file(s) into one data.zip file

  2. Create MD5 checksum of data.zip file to validate that upload file is not corrupt, e.g.:

DB211B14E25CFB18792C3B3697CD0394 data.zip

  1. Upload the data.zip file and the MD5 checksum to environment

REST URL via HTTP-PUT:

https://my.eu1.fredhopperservices.com/upload:[service_instance]/data/input/data.zip?checksum=[checksum]

cURL example:

  1. Save the data-id value from the response body for tracking purposes

  1. Trigger the processing of the newly uploaded data by creating a trigger that included the data-id value that was captured in step 4

REST URL:

cURL examples:

Example response (note the Location value in the header):

  1. Monitor the process by using the value of the 'Location' in the previous step and viewing the newly-created status file until the content is either SUCCESS or FAILURE.

REST URL:

cURL example:

Example response:

When successfully completed, the response should appear as follows:

hashtag
Process diagram

PreviousPreparing a Custom Data FeedNextCustom Data Feed Data Uploads

Last updated