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)

Last updated