Quickstart
Configure seu primeiro produto na Labanana em 5 passos.
Pré-requisito
Você precisa de acesso admin à API. Base URL: https://api.labanana.art
Fluxo completo
1. Criar ProductType
O ProductType define uma categoria de produto (ex: "Caneca Cerâmica").
POST /products/types
{
"slug": "caneca-ceramica",
"name": "Caneca Cerâmica",
"description": "Caneca de cerâmica personalizada",
"platformFeePercent": 15,
"artistRoyaltyPercent": 20
}
2. Adicionar Assets
Assets são características estruturais que afetam fabricação e custo.
POST /products/types/{product_type_id}/assets/bulk
{
"assets": [
{ "key": "size", "keyLabelPt": "Tamanho", "value": "350ml", "labelPt": "350ml" },
{ "key": "size", "keyLabelPt": "Tamanho", "value": "700ml", "labelPt": "700ml" },
{ "key": "finish", "keyLabelPt": "Acabamento", "value": "glossy", "labelPt": "Brilhante" },
{ "key": "finish", "keyLabelPt": "Acabamento", "value": "matte", "labelPt": "Fosco" }
]
}
3. Adicionar Options
Options são características visuais que o cliente escolhe na loja.
POST /products/types/{product_type_id}/options
{
"key": "color",
"labelPt": "Cor",
"inputType": "color_picker",
"displayBehavior": "filter",
"required": true,
"values": [
{ "value": "black", "labelPt": "Preto", "hexColor": "#000000" },
{ "value": "white", "labelPt": "Branco", "hexColor": "#FFFFFF" },
{ "value": "red", "labelPt": "Vermelho", "hexColor": "#FF0000" },
{ "value": "blue", "labelPt": "Azul", "hexColor": "#0000FF" }
]
}
4. Gerar Variants
Use o endpoint de geração automática para criar todas as combinações.
POST /products/types/{product_type_id}/generate-variants
{
"baseCostCents": 1500,
"productionDays": 3,
"packagingDays": 1
}
Isso gera 4 variants (2 sizes x 2 finishes), cada uma com custo padrão de R$ 15,00.
dica
Após gerar, use o bulk update para ajustar custos específicos (ex: 700ml custa mais).
5. Criar Templates
Templates são os mockups onde a arte será composta.
POST /products/types/{product_type_id}/templates
{
"displayName": "Caneca 350ml Preta",
"assets": { "size": "350ml" },
"options": { "color": "black" },
"config": {
"printArea": { "x": 100, "y": 50, "width": 400, "height": 300 },
"sourceImage": { "width": 1000, "height": 800 }
}
}
Depois, faça o upload da imagem base via fluxo de presign.
Pronto!
Seu catálogo está configurado. Agora o seller pode:
Próximos passos
- Entender Assets vs Options — A distinção mais importante da plataforma
- Fluxo Admin completo — Guia detalhado com todas as opções
- API Reference -- Todos os endpoints da plataforma