Zum Hauptinhalt gehen

FHR - How to: Migrate to customer-specific URLs

Documentation Team
  • Aktualisiert

    Introduction

    As a Fredhopper client, you use one or more customer-specific API endpoints and URLs to reach the (online) tools (Preview pages and Merchandising Studio).

    In the past, you could reach these endpoints and tools using shared URLs, e.g. "https://query.published.live1.fas.eu1.fredhopperservices.com/fredhopper/query".

    Warning:

    Shared URLs used to access API endpoints and (online) tools will be deprecated and discontinued in October 2026

    Your customer-specific URLs are created during onboarding and include your unique cloud account/tenant name. However, within the URLs, underscores must be replaced with hyphens:

    • Cloud account/username: your_account_name
    • within the URL: your-account-name

    Benefits of migrating

    Migrating from shared URLs to customer-specific URLs offers you various benefits:

    • Faster response time due to optimized authentication and request processing
    • Advanced capabilities through access to features like A/B testing, Single Sign-On (SSO), Keep-Alive conntection, and global API serving
    • Enhanced Monitoring capabilities, including but not limited to, improved monitoring of 5** error rate changes codes which allow Crownpeak to proactively correct these before performance is degraded.

    Customer-specific URLs

    All customer-specific URLs must include your cloud account/tenant name and specify one of the following environments:

    • live1
    • test1
    • test2
    • test3
    • test4

    Note:

    The environments available to you depend on your contractual agreement.

    The following lists provide examples for all available endpoints. We will use your-account-name and env1 as a placeholder for your account name and specified environment respectively.

    Query API

    URLDestinationPurpose
    https://your-account-name-query-env1.fas.global.fredhopperservices.com
    /fredhopper/query    		Query API published endpoint for your fas:env1

    Handling search, lister, and product detail requests sent by front-end

    Test environments: For development and testing only.

    https://your-account-name-query-env1.suggest.global.fredhopperservices.com
    /json    		Query API endpoint for your suggest:env1

    Handling of requests for search suggestions sent by front-end

    Test environments: For staging, development, and testing only.

    Data API 

    Warning: The name data end-point are not yet active. Please do not use these for the time being. We will confirm once this is ready to be used.

    URLDestinationPurpose
    https://your-account-name-data-env1.fas.global.fredhopperservices.com
    /data    		Data API endpoint for your fas:env1Accepting input data and downloading data
    https://your-account-name-data-env1.fas.global.fredhopperservices.com
    /trigger    		Trigger API endpoint for your fas:env1Accepting triggers for data processing and providing trigger status
    https://your-account-name-data-env1.fas.global.fredhopperservices.com/Preview pages for Data API for your fas:env1

    Reviewing of input, output, and trigger information by humans

    All environments: Not suitable for real back-end integration.

    Online tools (GUI) 

    URLDestinationPurpose
    https://your-account-name-config-env1.fas.global.fredhopperservices.com
    /fredhopper/query    		Query API pre-published endpoint for your fas:env1

    Handling search, lister, and product detail requests sent by staging front-end

    Live environment: Not suitable for handling front-end traffic.

    Test environments: For staging, development, and testing only.

    https://your-account-name-config-env1.fas.global.fredhopperservices.com
    /preview    		Preview pages for Query API pre-published endpoint for your fas:env1

    Reviewing pre-published state of configuration via built-in front-end by humans

    All environments: Not suitable for real front-end integration.

    https://your-account-name-query-env1.fas.global.fredhopperservices.com
    /preview    		Preview pages for Query API published endpoint for your fas:env1

    Reviewing published state of the configuration via built-on front-end by humans

    All environments: Not suitable for real front-end integration.

    https://your-account-name-config-env1.fas.global.fredhopperservices.com
    /fredhopper/admin    		Merchandising Studio for your fas:env1Managing business rules and other configurations
    https://your-account-name-config-env1.cru.global.fredhopperservices.com
    /config/running/ab-tests    		Configuration API endpoint for your cru:env1Handling of configuration of A/B testing requests sent by front-end
    https://your-account-name-report.insights.global.fredhopperservices.com/Insights dashboardViewing data

    Comparison: Old vs. new URL template

    Old New
    https://query.published.env1.fas.eu1.
    fredhopperservices.com/fredhopper/query

    https://your-account-name-query-env1.fas.global.fredhopperservices.com
    /fredhopper/query
    https://query.published.env1.suggest.eu1.
    fredhopperservices.com/your_account_name/json    		 https://your-account-name-query-env1.suggest.global.fredhopperservices.com
    /json

    https://my.eu1.fredhopperservices.com
    /fas:env1/data

    		 https://your-account-name-data-env1.fas.global.fredhopperservices.com/data

    Verwandte Beiträge

    Kommentare

    0 Kommentare

    Zu diesem Beitrag können keine Kommentare hinterlassen werden.