Navigation¶

https://{cluster-id}.api.esales.apptus.cloud/api/v2/export/navigation

GET¶

Deprecated

This endpoint is part of an API that has been deprecated and its end of life is 2024-04-30. All endpoints in this API version, including this, will be removed. Please upgrade to the latest version before 2024-04-30.

All API changes can be found here:

This endpoint will be replaced by navigation.

More information regarding the API versioning strategy can be found here.

An export of the navigation tree in Elevate.

Request¶

Header parameters¶

Name	Description	Example
Api-Key Required	Api-key that was supplied during on-boarding	`pkA123456789AB1BE..`
Accept-Encoding Required	Allows responses to be compressed using Gzip.	`gzip`

Query parameters¶

Name	Description	Example
market Required	The visitor market identifier. Must match the corresponding market identifier in the data feed.	`UK`
includeAppNodes	Whether to include nodes that were created in the app, defaults to false	`false`

curl -i \
-X GET \
-H 'Api-Key: pkA123456789AB1BE..' \
-H 'Accept-Encoding: gzip' \
"https://{cluster-id}.api.esales.apptus.cloud/api/v2/export/navigation?market=UK&includeAppNodes=false"

Response¶

Response codes¶

Status	Description
200	Query accepted. The data will be returned as an application/json-object.
400	Invalid or missing required arguments.
403	Incorrect cluster credentials.
404	Cluster not found.
406	No acceptable encoding found in Accept-Encoding header.
500	Server error such as cluster unavailable, busy or internal error. If 5xx errors persist, contact support and attach any information found in the response body.
503	The server in the cluster that received the request is currently unavailable or busy. It is recommended to retry the request. The time between request attempts should be increasing.

Response body¶

Example

application/json;charset=UTF-8

{
  "market" : "string",
  "type" : "FULL",
  "addOrUpdate" : [ {
    "id" : "/women/shirts",
    "title" : "Shirts",
    "type" : "PAGE",
    "customData" : { },
    "iconPath" : "/resources/images/navigation/shirts.jpg",
    "pageId" : "/se/women/shirts",
    "parentId" : "/women",
    "url" : "/shipping-and-returns"
  } ],
  "remove" : [ "string" ]
}

Schema

NavigationContainer¶

Name	Type	Description	Example
market Required	string	The market identifier for where the navigation should apply. Must match the corresponding market identifier in the data feed. Min length: `1`. Max length: `20`.
type Required	string	Type of import. PARTIAL amends to the existing tree, FULL replaces all nodes that originate from api imports (attempting to retain additions from the apps) while FORCE replaces ALL existing pages. We recommendusing PARTIAL or FULL to allow app users to extend the navigation. Supported values: `FORCE`, `FULL`, `PARTIAL`.	`FULL`
addOrUpdate	NavigationNode[]	Navigation nodes to add or update. Each node must have an id and a type and may specify the parent it should be placed under in the tree. Nodes on the same level will be inserted in order of appearance in the import.
remove	string[]	Navigation nodes to remove, based on ids. Only used in partial imports.

Schemas¶

Inner schemas

NavigationNode¶

Navigation nodes to add or update. Each node must have an id and a type and may specify the parent it should be placed under in the tree. Nodes on the same level will be inserted in order of appearance in the import.

Name	Type	Description	Example
id Required	string	An identifier to represent the node. It should be unique within the navigation Min length: `1`. Max length: `200`. Pattern: `[a-zA-Z0-9/_-]+`.	`/women/shirts`
title Required	string	The title of the node Min length: `1`. Max length: `200`.	`Shirts`
type Required	string	What kind of node this is. Different node types have additional required fields. PAGE nodes have a corresponding page (usually a category) and should make up the tree structure of the navigation while LINK and LABEL nodes can be used to add extra information to leaf nodes. Only PAGE nodes are intended to be navigable in the tree as LINK nodes should take the user elsewhere and LABEL nodes are purely cosmetic. Supported values: `PAGE`, `LABEL`, `LINK`.	`PAGE`
customData	<string, string>	A kay-value mapping of custom data fields. The same mapping will be returned in the result of landing-page and navigation requests. The key order is not guaranteed to be the same. Limited to 1000 characters and 50 keys per node. Allowed characters for keys are alphanumerical, '-' and '_'	`{"highlight":"true","viewableFrom":"2010-10-20 00:00:00"}`
iconPath	string	A path to an image to be used as an icon for the node Min length: `1`. Max length: `500`.	`/resources/images/navigation/shirts.jpg`
pageId	string	Required for page nodes! The pageId of the target page Min length: `1`. Max length: `200`.	`/se/women/shirts`
parentId	string	The id of the parent node in the navigation hierarchy. Omit or set to null for top level nodes. Only page nodes should be parent nodes! Min length: `1`. Max length: `200`. Pattern: `[a-zA-Z0-9/_-]+`.	`/women`
url	string	Required for link nodes! Either a suffix for the own domain or an entire url for another Min length: `1`. Max length: `200`.	`/shipping-and-returns`