¿Qué vas a construir?

Cada camino empieza con una llamada que funciona. Elige por lo que quieres hacer, no por el nombre de la API.

Vender en tu propia tiendaPáginas, catálogo, carrito y checkout con el SDK de Storefront.Storefront SDK Conectar tu sistema o ERPProductos, inventario, pedidos y entregas desde tu backend.Admin API Autenticar usuarios y appsRegistro, sesiones y tokens OAuth 2.0.Auth API Vender a través de agentesDescubrimiento, carrito y checkout para asistentes de compra.UCP API

Tu primera llamada

Un token de aplicación y una lectura del catálogo. Con eso ya estás dentro.

# 1. Token de la aplicación (Auth API)
curl -X POST https://auth.ecomiq.pe/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$ECOMIQ_CLIENT_ID" \
  -d "client_secret=$ECOMIQ_CLIENT_SECRET" \
  -d "scope=api_admin"

# 2. Primera lectura del catálogo (Admin API)
curl "https://api.ecomiq.pe/api/v1/catalog/products?limit=25" \
  -H "Authorization: Bearer $ECOMIQ_TOKEN"

Obtener credenciales Cómo se pagina Errores

Referencia

v1Cambios

Admin API413 operacionesCatálogo, inventario, clientes, pedidos, entregas y pagos.Storefront API71 operacionesCatálogo público, carritos, checkout y cuentas de cliente.Auth API17 operacionesRegistro de usuarios, sesiones y emisión de tokens.UCP API15 operacionesPerfiles, catálogo, carritos y checkout para agentes.

SDK de Storefront

@ecomiq/storefront es nuestro micro-framework de React para crear tiendas Ecomiq. Incluye rutas SSR, acceso a Storefront API, carrito, checkout y despliegue en Cloudflare Workers.

InstalaciónPaquete, React y estructura mínima del proyecto.ConfiguraciónDomain, API, tema, desarrollo y despliegue.CLIDesarrollo, build, deploy y archivos generados.Páginas y rutasRutas por archivo, loaders SSR, layout y serverApi.CarritoProvider, sesión por tienda y operaciones del carrito.DespliegueBuild y publicación en Cloudflare Workers.

Ver el SDK

Guías

Estas guías explican cómo elegir credenciales, enviar el contexto correcto y manejar las variantes que existen entre endpoints.

Prepara una integraciónCrea una aplicación OAuth, solicita un token y verifica una llamada.AutenticaciónElige el flujo y las credenciales según la API.Organización, tienda y vendedorCómo Admin y Storefront resuelven el alcance de una solicitud.PaginaciónCursor, page/pageSize o limit según la operación.ErroresFormatos de error y condiciones seguras para reintentar.Eventos de webhookLos eventos, sus modelos y el contrato de tu endpoint.