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:
Integrações com Vnda via webhooks: http://ajuda.vnda.com.br/integracoes/webhooks
Vnda Ajuda: http://ajuda.vnda.com.br/pt-BR/
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