Referencia de la API y de las integraciones de Idovio Commerce

Qué está disponible hoy

• En servicio

  Intermediario de conexiones en connect.idovio.com: retornos de OAuth y los avisos de privacidad que exigen Shopify y eBay.

• En servicio

  Aplicación web en idovio.app.

• Aún no público

  API de cuenta y espacio de trabajo: construida y cubierta por pruebas automáticas, pero todavía sin dirección pública. La referencia de abajo describe la versión del código fuente.

• Aún no público

  Todavía no se emiten claves de API para aplicaciones de terceros. Cuando se emitan, aquí se documentarán sus permisos y límites.

Autenticación

• Las personas entran con una cuenta Idovio: correo y contraseña, o Google. Las acciones sensibles piden un segundo factor (TOTP).
• En la web la sesión viaja en una cookie HttpOnly. Toda petición que cambie algo debe enviar el token CSRF en la cabecera X-Idovio-CSRF y venir de un origen permitido.
• Las aplicaciones de escritorio y móvil reciben el token de sesión una sola vez y lo envían como Authorization: Bearer.
• Cada petición de un espacio de trabajo se comprueba contra la pertenencia y el rol de quien ha iniciado sesión; los datos de un espacio nunca se devuelven a otro.

Intermediario de conexiones

Los proveedores devuelven al comerciante a estas direcciones tras el consentimiento y entregan aquí sus avisos de privacidad obligatorios. El intermediario no guarda nada: canjea la autorización por los tokens y los entrega al espacio de trabajo del propio comerciante.

Puntos de acceso REST

Todas las rutas son relativas al origen de la API. Peticiones y respuestas en JSON.

Herramientas para agentes externos

Un asistente externo actúa por el mismo plano de control que una persona. Una credencial lo identifica, pero cada llamada pasa igualmente por el espacio de trabajo, el permiso, la política, los límites y, cuando corresponde, la aprobación humana, y queda registrada.

• commerce.get_overview
• catalog.search
• supplier.rank_routes
• orders.search
• ui.navigate
• supplier.reroute
• price.update
• automation.run

Integraciones

Para cada conexión: cómo la autoriza el comerciante, qué puede hacer Idovio Commerce a través de ella, qué clases de datos trata y cómo llegan los cambios. La disponibilidad actual está en la página de Conexiones. Conexiones

Convenciones

• Los errores son JSON con un código estable y un mensaje legible. Una respuesta 429 incluye Retry-After.
• Toda respuesta incluye X-Request-Id. Envíe su propio valor en esa cabecera para seguir una petición de principio a fin.
• Las operaciones que cambian existencias, precios o pedidos usan una clave de idempotencia: repetir la petición nunca repite su efecto.

Protección de datos

• Las credenciales de conexión se cifran por espacio de trabajo antes de guardarse y la API nunca las devuelve.
• El comerciante puede desconectar un proveedor en cualquier momento; la autorización guardada se elimina.
• Las solicitudes de eliminación que envían los proveedores se confirman y se aplican al espacio de trabajo afectado.

Política de privacidadCondicionesSeguridadContacto técnico: idev@idovio.com