Navigation¶
https://{cluster-id}.api.esales.apptus.cloud/api/v2/export/navigation
GET¶
Deprecated
This feature will most likely be removed in new versions.
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 Apptus 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
{
"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. | |
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 | /women/shirts |
title Required | string | The title of the node | 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 | object | 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 | /resources/images/navigation/shirts.jpg |
pageId | string | Required for page nodes! The pageId of the target page | /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! | /women |
url | string | Required for link nodes! Either a suffix for the own domain or an entire url for another | /shipping-and-returns |