Skip to main content

Catalogs (1.0)

Download OpenAPI specification:Download

This service provides the following resources:

  • CRUD catalogs: /catalogs
  • Create a full catalog (with products, discounts, product recommandations)

Catalog

Api Command

Public

Api Public Catalog

Get public description

Get a catalog's public description

path Parameters
id
required
string

id

Responses

Response samples

Content type
application/json
{
  • "longDesc": "string",
  • "shortDesc": "string"
}

basic-error-controller

Basic Error Controller

operation-handler

Operation Handler

Catalogs

Get items

Get all catalogs

query Parameters
offset
integer <int64>
pageNumber
integer <int32>
pageSize
integer <int32>
paged
boolean
sort.sorted
boolean
sort.unsorted
boolean
target
string

Return selected fields only (multiple occurrences allowed for selecting multiple fields)

unpaged
boolean
Request Body schema: application/json

predicate

object

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "last": true,
  • "number": 0,
  • "size": 0,
  • "totalItems": 0,
  • "totalPages": 0
}

Create an item

Create a catalog

Request Body schema: application/json
required

request

Responses

Request samples

Content type
application/json
No sample

Response samples

Content type
application/json
No sample

Create a full catalog

Create a full catalog (with products, discounts, product recommandations)

query Parameters
reason
string
Default: "resource creation thru REST Api"

reason

Request Body schema: application/json
required

fullCatalog

object (AbstractCatalog)
Array of objects (CatalogItem)
locale
string

Country code in ISO 3166-2 format

Array of objects (Product)
Array of objects (CatalogItem)
storeId
string

Store identifier

Responses

Request samples

Content type
application/json
{
  • "catalog": {
    },
  • "discounts": [
    ],
  • "locale": "FR",
  • "products": [
    ],
  • "recommendations": [
    ],
  • "storeId": "string"
}

Response samples

Content type
application/json
{ }

Get recap quantities for a given field

Get a list of recap entries

query Parameters
offset
integer <int64>
pageNumber
integer <int32>
pageSize
integer <int32>
paged
boolean
sort.sorted
boolean
sort.unsorted
boolean
target
required
string

Return selected fields only (multiple occurrences allowed for selecting multiple fields)

unpaged
boolean
Request Body schema: application/json

predicate

object

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "last": true,
  • "number": 0,
  • "size": 0,
  • "totalItems": 0,
  • "totalPages": 0
}

Get item

Get a catalog by ID

path Parameters
id
required
string

id

Responses

Response samples

Content type
application/json
No sample

Update item

Update a catalog

path Parameters
id
required
string

id

Request Body schema: application/json
required

updateRequestItem

Responses

Request samples

Content type
application/json
No sample

Response samples

Content type
application/json
No sample

Delete item

Delete a catalog

path Parameters
id
required
string

id

Responses

Response samples

Content type
application/json
{ }