Integre Telesto con sus propias soluciones internas o servicios de terceros usando 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 usando su clave API en el header de Authorization:

Authorization: YOUR_API_KEY

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 header Authorization

Exceder el límite de velocidad resultará en un bloqueo temporal de 15 minutos para su 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 para mantener 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 (espere 15 min)
500 SERVER_ERROR Error interno, inténtelo más tarde

Ejemplo Rápido

Solicitud

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

Respuesta

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

Mejores Prácticas

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

Consejo: Pruebe su integración en lotes pequeños primero para asegurar que se mantenga 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úrese de tener una suscripción Pro
  2. Contacte al soporte para solicitar acceso a la API y obtener su clave
  3. Revise la documentación para los endpoints disponibles

Actualmente en Beta: Estamos expandiendo activamente los endpoints de la API y la funcionalidad. Si está interesado en usar la API o necesita endpoints específicos, por favor contacte a nuestro equipo de soporte.