Intégrez Telesto avec vos propres solutions internes ou des services tiers en utilisant notre API RESTful. Parfait pour les intégrations personnalisées et les flux de travail automatisés.

Prérequis : Abonnement Pro et clé API valide requis pour tous les endpoints.

Authentification

Toutes les requêtes API nécessitent une authentification utilisant votre clé API dans l'en-tête Authorization :

Authorization: VOTRE_CLE_API

URL de base

https://telesto.app/v2

Limites de taux

  • 100 requêtes par heure par adresse IP
  • Délai d'attente de 15 minutes si la limite de taux est dépassée
  • Toutes les requêtes doivent inclure la clé API dans l'en-tête Authorization

Le dépassement de la limite de taux entraînera un blocage temporaire de 15 minutes pour votre adresse IP.

Format de réponse

Toutes les réponses sont retournées au format JSON. Les champs vides ou null sont retournés comme des chaînes vides pour la cohérence.

Réponse de succès

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

Réponse d'erreur

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Clé API invalide"
    }
}

Codes d'erreur

Code Type Description
401 UNAUTHORIZED Clé API manquante ou invalide
403 FORBIDDEN Abonnement Pro requis
404 NOT_FOUND Ressource non trouvée
429 TOO_MANY_REQUESTS Limite de taux dépassée (attendre 15 min)
500 SERVER_ERROR Erreur interne, réessayez plus tard

Exemple rapide

Requête

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

Réponse

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

Bonnes pratiques

  • Stockez votre clé API de manière sécurisée (jamais dans le code côté client)
  • Implémentez une logique de nouvelle tentative pour les réponses 429 (limite de taux)
  • Mettez en cache les réponses quand c'est possible pour réduire les appels API
  • Utilisez HTTPS pour toutes les requêtes

Conseil : Testez votre intégration par petits lots d'abord pour vous assurer de rester dans les limites de taux.

Documentation complète

La documentation API complète avec des paramètres détaillés et des exemples est disponible à :

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

Premiers pas

  1. Assurez-vous d'avoir un abonnement Pro
  2. Contactez le support pour demander l'accès à l'API et obtenir votre clé
  3. Consultez la documentation pour les endpoints disponibles

Actuellement en Beta : Nous développons activement les endpoints et fonctionnalités de l'API. Si vous êtes intéressé par l'utilisation de l'API ou avez besoin d'endpoints spécifiques, veuillez contacter notre équipe de support.