Marketing

Banners
 Includes disponíveis: categories, collections, promotions, product
Listar banners
GET https://api.dooki.com.br/v2/{alias}/marketing/banners
Request
{
    "active": true,
    "home": true,
    "name": "Banner test",
    "link": "http://link.com",
    "image_url": "https://image-url.com/image.jpg",
    "start_at": "2017-05-06 00:00:00",
    "end_at": "2017-05-06 00:00:00",
    "categories_ids": [1, 2, 3],
    "collections_ids": [1, 2, 3],
    "promotions_ids": [1, 2, 3]
}
Response
{
    "data": {
        "id": 41,
        "active": true,
        "home": true,
        "name": "Banner test",
        "slug": "banner-test",
        "image_url": "https://image-url.com/image.jpg",
        "link": "http://link.com",
        "expired": true,
        "start_at": {
            "date": "2014-06-03 23:57:00.000000",
            "timezone_type": 3,
            "timezone": "America/Sao_Paulo"
        },
        "end_at": {
            "date": "2020-06-03 23:57:00.000000",
            "timezone_type": 3,
            "timezone": "America/Sao_Paulo"
        },
    }
}
Criar banner
POST https://api.dooki.com.br/v2/{alias}/marketing/banners
Parâmetro
Tipo
Obrigatório
Descrição
active
boolean
Sim
Status do banner.
home
boolean
Sim
Marca se o banner aparecerá no slide principal da home.
name
string
Sim
Nome do banner.
image_url
string
Sim
URL do arquivo do banner.
link
string
Não
Link do banner.
start_at
datetime
Sim
Início da validade do banner. Formato: yyyy-mm-dd H:i:s.
end_at
datetime
Sim
Fim da validade do banner. Formato: yyyy-mm-dd H:i:s.
collections_ids
array
Não
Lista de coleções que o banner estará presente.
categories_ids
array
Não
Lista de categorias que o banner estará presente.
promotions
array
Não
Lista de promoções que o banner estará presente.
product_id
int
Não
ID do produto, caso o banner seja composto por um produto.
stopwatch
string
Não
Tipo de cronômetro. Valores aceitos: null, daily ou expiration_date
Ordenar banners
PUT https://api.dooki.com.br/v2/{alias}/marketing/banners/{id}
Request de ordenação de banners
{
    "sorting": [
        {
            "group": "categories",
            "resource_id": 1,
            "orders": [1234, 123, 12334]
        },
        {
            "group": "promotions",
            "resource_id": 5,
            "orders": [1234, 123, 12334]
        }
    ]
}
Parâmetro
Tipo
Obrigatório
Descrição
sorting
array
Sim
Status do banner.
sorting[group]
string
Sim
Nome do grupo em que o banner está. Valores aceitos: collections, categories, promotions, home
sorting[resource_id]
int
Sim
ID do recurso que o banner pertence. Exemplo: se o banner estiver em uma categoria com ID 5, deverá ser passado resource_id:5
sorting[orders]
array
Sim
IDs dos banners já nas posições ordenadas.
Visualizar banner
GET https://api.dooki.com.br/v2/{alias}/marketing/banners/{id}
Atualizar banner
PUT https://api.dooki.com.br/v2/{alias}/marketing/banners/{id}
Excluir banner
DELETE https://api.dooki.com.br/v2/{alias}/marketing/banners/{id}
Lista de promoções que o banner pertence
GET https://api.dooki.com.br/v2/{alias}/marketing/banners/{id}/promotions
Lista de coleções que o banner pertence
GET https://api.dooki.com.br/v2/{alias}/marketing/banners/{id}/collections
Lista de categorias que o banner pertence
GET https://api.dooki.com.br/v2/{alias}/marketing/banners/{id}/categories

Referência da API - Previous

Logística

Next - Referência da API

Marketplaces

Last updated 2 years ago

Parâmetro	Tipo	Obrigatório	Descrição
active	boolean	Sim	Status do banner.
home	boolean	Sim	Marca se o banner aparecerá no slide principal da home.
name	string	Sim	Nome do banner.
image_url	string	Sim	URL do arquivo do banner.
link	string	Não	Link do banner.
start_at	datetime	Sim	Início da validade do banner. Formato: `yyyy-mm-dd H:i:s`.
end_at	datetime	Sim	Fim da validade do banner. Formato: `yyyy-mm-dd H:i:s`.
collections_ids	array	Não	Lista de coleções que o banner estará presente.
categories_ids	array	Não	Lista de categorias que o banner estará presente.
promotions	array	Não	Lista de promoções que o banner estará presente.
product_id	int	Não	ID do produto, caso o banner seja composto por um produto.
stopwatch	string	Não	Tipo de cronômetro. Valores aceitos: `null`, `daily` ou `expiration_date`