Configuration¶

https://{cluster-id}.api.esales.apptus.cloud/api/admin/v4/export/configuration

GET¶

An export of all currently configured markets.

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`

curl -i \
-X GET \
-H 'Api-Key: pkA123456789AB1BE..' \
-H 'Accept-Encoding: gzip' \
"https://{cluster-id}.api.esales.apptus.cloud/api/admin/v4/export/configuration"

Response¶

Response codes¶

Status	Description
200	Query accepted. The data will be returned as an application/json-object.
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

{
  "edit" : {
    "markets" : { }
  },
  "remove" : {
    "markets" : [ null ]
  },
  "replace" : {
    "markets" : { }
  }
}

Schema

Configuration¶

A config import must include exactly one of 'remove', 'replace', or 'edit'

Name	Type	Description
edit	ConfigEdit	The edit operation adds or changes the included markets
remove	ConfigRemove	The remove operation removes specific markets
replace	ConfigReplace	The replace operation fully replaces the configuration, removing all markets not included in the requests

Schemas¶

Inner schemas

ConfigEdit¶

Name	Type	Description	Example
markets	<string, MarketDefinition>	A mapping from market key to a market configuration

ConfigRemove¶

Name	Type	Description	Example
markets	string[]	Which markets to delete. Deleting a market will delete everything on that market, including products and settings (promotions, pages, etc.)!

ConfigReplace¶

Name	Type	Description	Example
markets	<string, MarketDefinition>	A mapping from market key to a market configuration

MarketDefinition¶

A complete or partial market definition

Name	Type	Description	Example
appSettings	AppSettings	How the market should be presented in the Elevate app interface. It is highly recommended to provide a display name and currency for the market.
locales	string[]	A list of which locales this market should support. New markets must include at least one locale!