{"info":{"_postman_id":"kandima-v1-2026-05-14","name":"KANDIMA API v1","description":"REST API pública de KANDIMA — el AI Operating System para ecommerce LATAM. Configurá la variable `apiKey` con tu Bearer token (formato `ka_live_...`).","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{apiKey}}","type":"string"}]},"variable":[{"key":"baseUrl","value":"https://kandima.ai/api/v1","type":"string"},{"key":"apiKey","value":"ka_live_REEMPLAZA_AQUI","type":"string"}],"item":[{"name":"status","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/status","host":["{{baseUrl}}"],"path":["status"],"query":[]},"description":"Health check público (sin auth)"},"response":[]},{"name":"me","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/me","host":["{{baseUrl}}"],"path":["me"],"query":[]},"description":"Tu perfil + plan + workspace"},"response":[]},{"name":"credits","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/credits","host":["{{baseUrl}}"],"path":["credits"],"query":[]},"description":"Balance de créditos KANDIMA"},"response":[]},{"name":"customers","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/customers?limit=50","host":["{{baseUrl}}"],"path":["customers"],"query":[{"key":"limit","value":"50"}]},"description":"Lista de clientes con LTV, segment, churn score"},"response":[]},{"name":"integrations","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/integrations","host":["{{baseUrl}}"],"path":["integrations"],"query":[]},"description":"Tus integraciones conectadas (Shopify/TN/ML/Meta/etc)"},"response":[]},{"name":"insights","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/insights?status=open&severity=warning","host":["{{baseUrl}}"],"path":["insights"],"query":[{"key":"status","value":"open"},{"key":"severity","value":"warning"}]},"description":"AI insights generados por los crons KANDIMA"},"response":[]},{"name":"profit","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/profit?days=30","host":["{{baseUrl}}"],"path":["profit"],"query":[{"key":"days","value":"30"}]},"description":"Profit snapshot (revenue - refunds - ads spend - expenses)"},"response":[]},{"name":"anomalies","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/anomalies?days=14&severity=high","host":["{{baseUrl}}"],"path":["anomalies"],"query":[{"key":"days","value":"14"},{"key":"severity","value":"high"}]},"description":"Anomalías detectadas (z-score sobre métricas)"},"response":[]},{"name":"inventory","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/inventory?status=critical&limit=50","host":["{{baseUrl}}"],"path":["inventory"],"query":[{"key":"status","value":"critical"},{"key":"limit","value":"50"}]},"description":"SKUs con velocidad, días-de-stock y stockout estimado"},"response":[]},{"name":"reorder","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/reorder?status=pending&limit=50","host":["{{baseUrl}}"],"path":["reorder"],"query":[{"key":"status","value":"pending"},{"key":"limit","value":"50"}]},"description":"Smart reorder suggestions con cantidad y confidence"},"response":[]},{"name":"ads","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/ads?platform=meta&level=campaign&limit=50","host":["{{baseUrl}}"],"path":["ads"],"query":[{"key":"platform","value":"meta"},{"key":"level","value":"campaign"},{"key":"limit","value":"50"}]},"description":"Ad campaigns cross-platform (Meta/Google/TikTok) normalizadas"},"response":[]},{"name":"creatives","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/creatives?recommendation=scale&limit=50","host":["{{baseUrl}}"],"path":["creatives"],"query":[{"key":"recommendation","value":"scale"},{"key":"limit","value":"50"}]},"description":"Creative Intelligence — winner score, fatigue, recommendation"},"response":[]},{"name":"health","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/health","host":["{{baseUrl}}"],"path":["health"],"query":[]},"description":"Workspace health consolidado — credits/integrations/insights/alerts"},"response":[]},{"name":"conversations","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/conversations?channel=whatsapp&limit=50","host":["{{baseUrl}}"],"path":["conversations"],"query":[{"key":"channel","value":"whatsapp"},{"key":"limit","value":"50"}]},"description":"Threads de mensajería (WhatsApp por ahora; IG/Messenger pronto)"},"response":[]},{"name":"conversations-stats","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/conversations/stats?days=30","host":["{{baseUrl}}"],"path":["conversations","stats"],"query":[{"key":"days","value":"30"}]},"description":"Agregados del bot — conversaciones, mensajes, escalaciones, ventas USD, envíos de automatizaciones por tipo"},"response":[]},{"name":"webhooks-list","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/webhooks","host":["{{baseUrl}}"],"path":["webhooks"],"query":[]},"description":"Tus webhook subscriptions"},"response":[]},{"name":"webhooks-create","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"url\": \"https://my-app.com/webhooks/kandima\",\n  \"events\": [\n    \"*\"\n  ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{baseUrl}}/webhooks","host":["{{baseUrl}}"],"path":["webhooks"]},"description":"Crear webhook subscription"},"response":[]},{"name":"track","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"event\": \"checkout_started\",\n  \"props\": {\n    \"plan\": \"pro\"\n  },\n  \"url\": \"https://miapp.com/checkout\",\n  \"visitor_id\": \"v_abc123\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{baseUrl}}/track","host":["{{baseUrl}}"],"path":["track"]},"description":"Ingest custom analytics event"},"response":[]},{"name":"openapi-spec","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/openapi.json","host":["{{baseUrl}}"],"path":["openapi.json"],"query":[]},"description":"OpenAPI 3.0 spec — auto-generate SDKs"},"response":[]}]}