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 en utilisant votre clé API dans l'en-tête Authorization :

Authorization: VOTRE_CLE_API

URL de base

https://telesto.app/v2

Limites de débit

  • 100 requêtes par heure par adresse IP
  • Délai d'expiration de 15 minutes si la limite de débit 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 débit 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 nuls sont retournés comme 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 débit 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"
    }
]

Meilleures pratiques

  • Stockez votre clé API de manière sécurisée (jamais dans le code côté client)
  • Implémentez une logique de retry pour les réponses 429 (limite de débit)
  • 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 débit.

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

Pour commencer

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

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