LogoLogo
Fredhopper Integration Guide
Fredhopper Integration Guide
  • Fredhopper Integration Guide
  • Fredhopper Integration Guide
    • Data Integration
      • Item Data Structure
        • Full Feeds
          • Full Feed JSON Data Format
          • Full Feed CSV Data Format
        • Incremental Feeds
          • Incremental Feed JSON Data Format
          • Incremental Feed CSV Data Format
        • Full and Incremental Feed Uploads
      • Suggest Service Data Feeds
        • Suggest Service Data Format
        • Suggest Data Uploads
      • Custom Data Feeds
        • Custom Data Format
        • Custom Data Uploads
        • Services API Fail Safe Features
    • Front-End Integration
      • Understanding the Fredhopper Query API
      • Using the Fredhopper Query API
      • Fredhopper Query Language
      • Redirects - REST vs. SOAP
      • Query API Fail Safe Features
      • Integration Best Practices
      • Suggest
      • Definitions
      • Fredhopper Query and Response Samples
    • Glossary
Powered by GitBook

Copyright @ 2024 Crownpeak Technology, Inc. All rights reserved.

On this page
  • Services
  • Service Instances
  • Environment
  • Configuration States
  • Interfaces
  • Endpoints
  • Regions
  1. Fredhopper Integration Guide
  2. Front-End Integration

Definitions

The following section defines the different terminology that is used and referred to within the Fredhopper Managed Services space.

Services

Service = A software product offered as a service.

Fredhopper offers the following services:

Fredhopper Services
Short Name

Onsite Search & Targeting

fas

Predictive Targeting - Search Suggest

suggest

Predictive Targeting - Recommendations (depreciated)

recos

Service Instances

Service Instance = Each unique occurrence of a Service.

A Fredhopper Service includes one Instance. Additional Service Instances can be requested as required.

Service Instances
Description

live1

The default Service Instance

test1

An example of an extra Service Instance

Environment

Environment is a name assigned to a particular set of service instances that fulfil a business function. An example environment "production" could be defined as using the fas:live1, suggest:live1, and upload:live1 service instances.

Configuration States

Configuration State = the State of the configuration of a Service Instance: Published or Pre-published.

Configuration State
Description

published

Configuration visible to all users

prepublished

Configuration visible to users with preview rights (business managers)

Interfaces

Interface = a way to request functions from a Service

Interface
Short Name
Description

Query API

query

The Query API is the way to send queries to Fredhopper via SOAP/REST like e.g. Give me all red t-shirts for less than 50 EUR

Fredhopper Services API

my

The Fredhopper Services API is the way to upload/download data and control processes, like e.g. start re-index

Business Manager

bm

The Business Manager is the way for business managers to change the response of the Fredhopper Service, e.g. Add a promotion

Endpoints

An endpoint is provided by a service instance for a particular combination of an interface and a configuration state. Not all combinations of interface and configuration state are possible and define a valid endpoint.

The table below lists common endpoints:

Endpoint
Description

query.published

Endpoint for the query interface of the published configuration state, used by a frontend to query FAS

query.prepublished

Endpoint for the query interface of the prepublished configuration state, used by a preview/test frontend to query FAS

Regions

Region = a global area in which a service is provided.

Region
Description

eu1

Europe

us1

US (west)

ap2

Australia (Sydney)

PreviousSuggestNextFredhopper Query and Response Samples

Last updated 8 months ago