Integra Telesto con tus propias soluciones internas o con servicios de terceros mediante nuestra API RESTful. Ideal para integraciones personalizadas y flujos de trabajo automatizados.

Requisitos previos: se necesita una suscripción Pro y una clave de API válida para todos los endpoints.

Qué puedes hacer

  • Productos crea, consulta, actualiza y elimina tu catálogo
  • Stock por almacén consulta exactamente dónde está el stock de cada producto, no solo el total de la cuenta
  • Transacciones registra entradas y salidas de stock, y consulta el registro completo para conciliarlo con tu propio sistema
  • Categorías, ubicaciones y proveedores crea, consulta, actualiza y elimina por completo

Referencia de la API

La referencia completa documenta cada endpoint, parámetro y respuesta, con ejemplos de código listos para usar en curl, PHP, Python, Node y Ruby. También puedes enviar solicitudes reales a tu propia cuenta directamente desde la página.

https://www.telesto.app/docs/api

Autenticación

Envía tu clave de API en la cabecera Authorization en cada solicitud. Envía la clave sin procesar, sin el prefijo Bearer:

Authorization: YOUR_API_KEY

Límites de uso

100 solicitudes por hora, contabilizadas por clave de API. Si superas ese límite, se te bloquea durante 15 minutos, y la respuesta te indica cuánto tiempo debes esperar. Las solicitudes que fallan en la autenticación se contabilizan según tu dirección IP, de modo que una clave incorrecta nunca consume tu cuota.

Buenas prácticas

  • Guarda tu clave de API de forma segura, nunca en código del lado del cliente
  • Solicita páginas grandes en lugar de hacer muchas solicitudes pequeñas, y guarda en caché todo lo que no cambie con frecuencia
  • Respeta la cabecera Retry-After en vez de reintentar de inmediato una solicitud limitada por el ritmo de uso
  • Al actualizar un registro, envía solo los campos que quieras modificar. Todo lo que omitas conserva su valor actual
  • Si una transacción de stock agota el tiempo de espera, revisa la lista de transacciones antes de enviarla de nuevo. Reintentar sin comprobar puede mover el mismo stock dos veces

Primeros pasos

  1. Asegúrate de tener una suscripción Pro
  2. Ponte en contacto con soporte para solicitar acceso a la API y obtener tu clave
  3. Abre la referencia de la API y prueba una solicitud directamente desde la página

Actualmente en Beta: Estamos ampliando activamente los endpoints y las funcionalidades de la API. Si te interesa usar la API o necesitas endpoints específicos, ponte en contacto con nuestro equipo de soporte.