YAyampi
Promoções - Produtos

Listar promoções

Lista todas as promoções

get/{alias}/pricing/promotions

Request

  • Base URL
    https://api.dooki.com.br/v2
  • URL
    https://api.dooki.com.br/v2/{alias}/pricing/promotions
  • Auth
    API key in header User-Token and API key in header User-Secret-Key

Path parameters

aliasstring required

Alias da loja

Request body

activeboolean required

Status da promoção

all_productsboolean required

Aplicar em todos os produtos

utm_onlyboolean required

Exclusivo para UTM

highlight_on_menuboolean

Destacar no menu

accumulateboolean

Permite acumular com outras promoções

price_attribute'price_sale' | 'price_discount' required

Atributo de preço para aplicar desconto

namestring required

Nome da promoção

valuenumber float required

Valor do desconto

utm_sourcestring

Origem UTM

utm_campaignstring

Campanha UTM

start_atstring date-time required

Data e hora de início

end_atstring date-time required

Data e hora de término

collections_idsinteger[]

IDs das coleções

brands_idsinteger[]

IDs das marcas

categories_idsinteger[]

IDs das categorias

banners_idsinteger[]

IDs dos banners

Example request

{
  "active": true,
  "all_products": true,
  "utm_only": true,
  "highlight_on_menu": true,
  "accumulate": true,
  "price_attribute": "price_discount",
  "name": "Black Friday 2025",
  "value": 123,
  "utm_source": "google",
  "utm_campaign": "black_friday",
  "start_at": "2025-11-25 00:00:00",
  "end_at": "2025-11-30 23:59:59",
  "collections_ids": [
    1,
    2
  ],
  "brands_ids": [
    1,
    2
  ],
  "categories_ids": [
    1,
    2
  ],
  "banners_ids": [
    1,
    2
  ]
}

Response

Lista de promoções

Example response

{
  "data": [
    {
      "name": "Promoção relâmpago",
      "url": "https://www.domain.com/promocoes/test",
      "utm_source": "google",
      "utm_campaign": "adwords"
    }
  ]
}

Changes

No recorded changes to this operation across all 3 revisions of this API.