Skip to content

Navigation

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

POST

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:

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

An import of navigation nodes. The navigation tree can be partially modified or fully replaced, either while retaining or deleting nodes created in the app. Elevate will attempt to maintain the relative position of retained nodes if their parent nodes are moved or if siblings are reordered. If a parent node is deleted all child nodes will be deleted implicitly.

Request

Header parameters

Name Description Example
Api-Key
Required
Api-key that was supplied during on-boarding pkA123456789AB1BE..
Accept-Encoding Allows responses to be compressed using Gzip. gzip
Content-Encoding Defines which encoding was used to compress the data. gzip
Content-Type application/json application/json

Query parameters

Name Description Example
name A name to identify the import in logs

Supported Content-Type

application/json

Request body

Example
application/json
{
  "market" : null,
  "type" : "FULL",
  "addOrUpdate" : [ {
    "id" : "/women/shirts",
    "title" : "Shirts",
    "type" : "PAGE",
    "customData" : {
      "highlight" : "true",
      "viewableFrom" : "2010-10-20 00:00:00"
    },
    "iconPath" : "/resources/images/navigation/shirts.jpg",
    "pageId" : "/se/women/shirts",
    "parentId" : "/women",
    "url" : "/shipping-and-returns"
  } ],
  "remove" : [ null ]
}
Schema
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. "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.
curl -i \
-X POST \
-H 'Api-Key: pkA123456789AB1BE..' \
-H 'Accept-Encoding: gzip' \
-H 'Content-Encoding: gzip' \
-H 'Content-Type: application/json' \
"https://{cluster-id}.api.esales.apptus.cloud/api/v2/import/navigation?name=name" \
-T request-body.file.gz

Response

Response codes

Status Description
204 The import file was valid.
403 Incorrect cluster credentials.
404 Cluster not found.
409 An import is currently in progress.
500 Server error such as cluster unavailable or busy. If 5xx errors persist, contact support and attach any information found in the response body.

Schemas

Inner schemas
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. "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"
×
Copyright

This online publication is intellectual property of Voyado Lund AB. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Voyado Lund AB nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Voyado Lund AB essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.

CLOSE