📚 Documentação da API REST

API para integração com o webapp Lisdamas IA (WhatsApp Business Bot)

🔑 Credenciais de Acesso
Use estas credenciais para autenticar requisições da API
https://lisdamas-lkfv8xcf.manus.space/api/bot
Configurada no servidor (lisdamas_api_key)

Endpoints Disponíveis

GET/dresses
Lista vestidos disponíveis com filtros opcionais

Query Parameters:

  • occasion - Ocasião (ex: "formatura", "casamento")
  • color - Cor do vestido
  • style - Estilo (ex: "longo", "curto")
  • size - Tamanho (PP, P, M, G, GG)
  • available_from - Data início (YYYY-MM-DD)
  • available_to - Data fim (YYYY-MM-DD)
  • limit - Limite de resultados (padrão: 50)

Exemplo de Resposta:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "code": "VEST001",
      "name": "Vestido Longo Azul Marinho",
      "description": "Vestido longo elegante...",
      "occasion": "formatura",
      "color": "azul",
      "style": "longo",
      "sizes": ["P", "M", "G"],
      "price": 350.00,
      "photos": ["https://..."],
      "isAvailable": true
    }
  ],
  "total": 45
}
GET/dresses/:id
Busca detalhes de um vestido específico

Retorna informações completas do vestido incluindo fotos e tamanhos disponíveis.

GET/accessories
Lista acessórios disponíveis (clutches, estolas, brincos, colares) com filtros opcionais

Query Parameters:

  • category - Categoria ("clutch", "stole", "earrings", "necklace")
  • color - Cor do acessório
  • minPrice - Preço mínimo (em centavos)
  • maxPrice - Preço máximo (em centavos)
  • search - Busca no nome/descrição
  • limit - Limite de resultados (padrão: 50)

Exemplo de Resposta:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Clutch dourada",
      "description": "Clutch elegante...",
      "category": "clutch",
      "color": "Dourado",
      "price": 5990,
      "priceFormatted": "R$ 59,90",
      "imageUrl": "https://...",
      "additionalImages": []
    }
  ],
  "count": 20
}
GET/accessories/:id
Busca detalhes de um acessório específico

Retorna informações completas do acessório incluindo fotos e categoria.

💡 Exemplo de Uso (JavaScript/Node.js)
// Exemplo: Buscar vestidos para formatura
const response = await fetch('https://lisdamas-lkfv8xcf.manus.space/api/bot/dresses?occasion=formatura&limit=10', {
  headers: {
    'X-API-Key': 'Configurada no servidor (lisdamas_api_key)'
  }
});

const data = await response.json();
console.log(data);

// Exemplo: Buscar clutches
const clutches = await fetch('https://lisdamas-lkfv8xcf.manus.space/api/bot/accessories?category=clutch&limit=10', {
  headers: {
    'X-API-Key': 'Configurada no servidor (lisdamas_api_key)'
  }
});

const clutchData = await clutches.json();
console.log(clutchData);

// Exemplo: Buscar estolas
const stoles = await fetch('https://lisdamas-lkfv8xcf.manus.space/api/bot/accessories?category=stole', {
  headers: {
    'X-API-Key': 'Configurada no servidor (lisdamas_api_key)'
  }
});

const stoleData = await stoles.json();
console.log(stoleData);