Para acessar as documentações de API da Vnda:


1. Acesse o https://demo.vnda.com.br/api/v2/docs/index.html


Outras documentações:




Abaixo um exemplo de filtro de data e paginação;

Data:

/api/v2/orders?start=20191010&finish=20191011

Paginação:

As informações são disponibilizadas no header x-pagination caso exista paginação.

Ex:

x-pagination: {"total_pages":337,"total_count":33645,"current_page":1,"prev_page":false,"next_page":true}

Listando a página 2:

/api/v2/orders?page=2


Abaixo um exemplo de autenticação:

Quais chamadas de API permitem o controle de imagens de produtos?

/api/v2/products/{id}/images

/api/v2/products/{product_id}/variants/{variant_id}/images para listar as imagens associadas a determinado SKU


Mais detalhes:


Listar as imagens do produto

GET https://demo.vnda.com.br/api/v2/products/:product_id/images

[

{

"updated_at" : "2021-03-17T15:09:41.829-03:00",

"id" : 177,

"url" : "//b4.vnda.com.br/demo/2021/03/17/15_3_4_488_10_7_5_537_SoPureMoisturizingTreatment200ml.jpg?1616004581",

"variant_ids" : []

},

{

"variant_ids" : [

289

],

"url" : "//b0.vnda.com.br/demo/2021/03/17/15_3_4_483_11_10_1_187_SoPureMoisturizingTreatment200ml_verso.jpg?1616004572",

"updated_at" : "2021-03-17T15:09:32.412-03:00",

"id" : 176

}

]


Listar imagens atribuidas a SKUs específicos

GET https://demo.vnda.com.br/api/v2/products/:product_id/variants/:sku/images

[

{

"url" : "//b2.vnda.com.br/demo/2021/03/17/15_3_4_483_11_10_1_187_SoPureMoisturizingTreatment200ml_verso.jpg?1616004572",

"updated_at" : "2021-03-17T15:09:32.412-03:00"

}

]


Cadastrar imagem

POST https://demo.vnda.com.br/api/v2/products/:product_id/images?file_url=:url

O parâmetro :url deve ser um endereço da internet, acessível de forma pública (sem necessidade de login)

A API irá baixar uma cópia da imagem para dentro do produto


Remover imagem

DELETE https://demo.vnda.com.br/api/v2/products/:product_id/images/:image_id

Retorna HTTP 204 quando a operação for executada com sucesso


Ordenar imagem

POST https://demo.vnda.com.br/api/v2/products/:product_id/images/:image_id/reorder

O parâmetro :sorted_ids deve conter os IDs das imagens dos produtos na ordem desejava

Exemplo:

curl \

-H "Authorization: Token \"xxx\"" \

-H "Content-Type: application/json" \

-d '{"ids": [176,177]}'

-X POST "https://demo.vnda.com.br/api/v2/products/92/images/reorder"

Retorna HTTP 200 quando a operação for executada com sucesso


Associar imagem a uma variante

POST https://demo.vnda.com.br/api/v2/products/:product_id/images/:image_id/add_variant?variant_id=:variant_id

O parâmetro :variant_id deve conter o ID de uma variante previamente cadastrada no produto

Retorna HTTP 200 quando a operação for executada com sucesso


Desassociar imagem de uma variante

POST https://demo.vnda.com.br/api/v2/products/:product_id/images/:image_id/remove_variant?variant_id=:variant_id

O parâmetro :variant_id deve conter o ID de uma variante previamente cadastrada no produto

Retorna HTTP 200 quando a operação for executada com sucesso