Agendar demo
Introducción
API Catálogo v1

Introducción

Una API REST sobre HTTPS que devuelve JSON. Gestiona tu catálogo de productos —productos, variantes, categorías, marcas y unidades— desde cualquier sistema externo.

URL base

Base URL https://emdimo.co/api/v1
  • Los endpoints de lista devuelven máximo 1000 registros por llamada; usa limit y offset para paginar.

Autenticación

Cada llamada requiere dos cabeceras HTTP:

Emdimo-Api-Key:   ek_live_xxxxxxxxxxxxxxxx
Emdimo-Api-Token: et_live_xxxxxxxxxxxxxxxx

Las generas en el backoffice: Configuración → Cuenta → API Keys (solo el dueño o un administrador). El token se muestra una sola vez al crearlo — guárdalo en un gestor de secretos.

Permisos (scopes)

ScopePermite
catalogo.read Leer — todos los GET
catalogo.write Crear y modificar — POST / PATCH / PUT / DELETE

Sin el scope requerido la respuesta es 403 forbidden.

Ejemplo rápido

# Primer producto del tenant
curl "https://emdimo.co/api/v1/catalog/products?limit=1" \
  -H "Emdimo-Api-Key: ek_live_xxxxxxxx" \
  -H "Emdimo-Api-Token: et_live_xxxxxxxx"

Estructura de los recursos

El catálogo tiene tres capas:

  • Productos — el ítem stockeable. Cada registro tiene un código sku único y puede ser simple o variante de un Grupo.
  • Grupos de variantes — contenedor que agrupa variantes de un mismo artículo base (p. ej. "Camiseta Azul" en tallas S/M/L). Los productos variantes se vinculan con product_id.
  • Atributos y valores — especificaciones (material, color) y ejes de variante (talla) que describen productos y grupos.

Los recursos de soporte (Categorías, Marcas, Unidades) se crean una vez y se referencian por id desde los productos.