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

Requisitos previos: Se requiere suscripción Pro y clave API válida para todos los endpoints.

Autenticación

Todas las solicitudes de API requieren autenticación utilizando tu clave API en el encabezado Authorization:

Authorization: TU_CLAVE_API

URL Base

https://telesto.app/v2

Límites de Velocidad

  • 100 solicitudes por hora por dirección IP
  • Tiempo de espera de 15 minutos si se excede el límite de velocidad
  • Todas las solicitudes deben incluir la clave API en el encabezado Authorization

Exceder el límite de velocidad resultará en un bloqueo temporal de 15 minutos para tu dirección IP.

Formato de Respuesta

Todas las respuestas se devuelven en formato JSON. Los campos vacíos o nulos se devuelven como cadenas vacías por consistencia.

Respuesta de Éxito

{
    "id": "abc123...",
    "name": "Mi Producto",
    "created": "2024-01-15 10:30:00"
}

Respuesta de Error

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Clave API inválida"
    }
}

Códigos de Error

Código Tipo Descripción
401 UNAUTHORIZED Clave API faltante o inválida
403 FORBIDDEN Se requiere suscripción Pro
404 NOT_FOUND Recurso no encontrado
429 TOO_MANY_REQUESTS Límite de velocidad excedido (esperar 15 min)
500 SERVER_ERROR Error interno, inténtalo más tarde

Ejemplo Rápido

Solicitud

curl -X GET "https://telesto.app/v2/products" 
  -H "Authorization: TU_CLAVE_API"

Respuesta

[
    {
        "id": "a1b2c3...",
        "name": "Widget",
        "ean_upc": "123456789",
        "stock_onhand": "50",
        "created": "2024-01-15 10:30:00"
    }
]

Mejores Prácticas

  • Almacena tu clave API de forma segura (nunca en código del lado del cliente)
  • Implementa lógica de reintento para respuestas 429 (límite de velocidad)
  • Almacena en caché las respuestas cuando sea posible para reducir las llamadas API
  • Usa HTTPS para todas las solicitudes

Consejo: Prueba tu integración en pequeños lotes primero para asegurar que te mantienes dentro de los límites de velocidad.

Documentación Completa

La documentación completa de la API con parámetros detallados y ejemplos está disponible en:

https://documenter.getpostman.com/view/3493/2s93Y2R1a8

Primeros Pasos

  1. Asegúrate de tener una suscripción Pro
  2. Contacta al soporte para solicitar acceso a la API y obtener tu clave
  3. Revisa la documentación para los endpoints disponibles

Actualmente en Beta: Estamos ampliando activamente los endpoints y funcionalidades de la API. Si estás interesado en usar la API o necesitas endpoints específicos, por favor contacta a nuestro equipo de soporte.