01Base URL

02Autenticación

Toda llamada requiere bearer token JWT obtenido vía Supabase Auth.

curl -X POST https://marketplace.smconnection.cl/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"usuario@ejemplo.cl","password":"***"}'

Respuesta:

{
  "access_token": "eyJhbGc...",
  "refresh_token": "eyJhbGc...",
  "expires_in": 3600,
  "tenant_id": "uuid-tenant"
}

Usar token en headers de toda llamada posterior:

Authorization: Bearer eyJhbGc...

03Endpoints principales

GET /api/products

Lista productos del tenant. Soporta filtros y paginación.

curl -H "Authorization: Bearer $TOKEN" \
  "https://marketplace.smconnection.cl/api/products?limit=20&offset=0"

Query params:

• limit (default 20 · max 100)
• offset (default 0)
• channel (meli · d2c · b2g · b2b · all)
• category_id
• search (busca en nombre · descripción)
• order (default created_at.desc)

GET /api/opportunities

Devuelve oportunidades scored (sin LLM). Ver ADR-0001.

curl -H "Authorization: Bearer $TOKEN" \
  "https://marketplace.smconnection.cl/api/opportunities?min_score=70"

POST /api/sync/meli

Dispara sincronización con MeLi (proxy OAuth).

curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://marketplace.smconnection.cl/api/sync/meli

GET /api/data

Endpoint genérico tabla. Cuidado con order por defecto.

04Códigos error

05Rate limits

• 60 requests/minuto por usuario
• 600 requests/minuto por IP
• Headers de respuesta: X-RateLimit-Limit · X-RateLimit-Remaining · X-RateLimit-Reset

06SDK JS (futuro Q2 2027)

Por ahora sólo curl/fetch directo. SDK oficial en roadmap:

// borrador del SDK · NO existe aún
import { MarketplaceSMC } from '@smc/sdk-js'

const client = new MarketplaceSMC({ apiKey: '...' })

const products = await client.products.list({ limit: 20 })
const opps = await client.opportunities.list({ minScore: 70 })
await client.sync.meli()

07Colección Postman

Descargar colección curada con todos los endpoints:

https://marketplace.smconnection.cl/docs/postman/Marketplace-SMC.json

Importar en Postman:

• File → Import → URL
• Pegar URL
• Configurar environment con base_url y access_token
• Run collection completa para smoke test

08Webhooks (Q3 2027)

Suscribir a eventos asincrónicos:

• product.synced
• order.created
• inventory.low_stock
• opportunity.detected

Endpoint registro:

POST /api/webhooks/subscribe
{ "url": "https://tuapp.cl/hook", "events": ["order.created"] }