eComunik2Software en la nube

API para desarrolladores

Integre su CRM, su sistema de cobros o su bot con la gestión de clientes de eComunik2.

Reglas de seguridad

  • Solo desde IP registradas. Pida a eComunik2 que autorice la IP (o el rango) de su servidor; cualquier otra conexión recibe 403 ip_no_autorizada.
  • Tokens de vida corta. El acceso (JWT ES256) dura 5 minutos. Renuévelo con el token de renovación, que es de un solo uso: si se reusa, la sesión completa se cierra.
  • Verificación en dos pasos. Si su cuenta la tiene, envíe codigo al pedir el token.
  • Errores con código. {"error":{"code":"…","mensaje":"…"}} y el estado HTTP correspondiente.

Ejemplo

# 1. Token (desde una IP autorizada)
curl -s -X POST https://ecomunik2.com/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"…","codigo":"123456"}'

# 2. Usar el acceso (vence en 5 min)
curl -s https://ecomunik2.com/api/v1/clientes -H "Authorization: Bearer ACCESO"

# 3. Renovar antes de que venza: guarde la renovación NUEVA, la anterior ya no sirve
curl -s -X POST https://ecomunik2.com/api/v1/auth/renovar -H "Content-Type: application/json" -d '{"renovacion":"RENOVACION"}'

Rutas

Base: https://ecomunik2.com/api/v1 · producto: laboratorio, factura, taller o condominio.

POST/auth/token
{email, password, codigo?} → token de acceso (Bearer) y token de renovación
POST/auth/renovar
{renovacion} → acceso y renovación nuevos (la renovación es de un solo uso)
POST/auth/salir
Cierra la sesión del token
GET/yo
Quién es el token (cuenta de la consola o distribuidor con su saldo)
GET/productos
Productos y campos propios del alta
GET/clientes?q=&producto=
Clientes de todos los productos
GET/productos/{producto}/planes
Planes del producto
PUT/productos/{producto}/planes/{id}
Crear o editar un plan (superusuario)
GET/productos/{producto}/clientes
Clientes del producto
POST/productos/{producto}/clientes
Alta de un cliente
GET/productos/{producto}/clientes/{subdominio}
Ficha y pagos
PATCH/productos/{producto}/clientes/{subdominio}
Cambiar estado, plan, modalidad, vencimiento…
POST/productos/{producto}/clientes/{subdominio}/renovar
Renovar (distribuidor: con su saldo)
GET/saldo
Saldo y movimientos del distribuidor
GET/distribuidores
Distribuidores (cuentas de la consola)