Search docs

Search the TryOnCloud API docs

Guides

Historique des modifications de l'API

Toutes les modifications apportées à l'API développeur, classées par ordre chronologique (les plus récentes en premier).

Les exemples de code, les points de terminaison et les codes d'erreur sont identiques dans tous les langages.

Modifications apportées à l'API pour développeurs, classées par ordre chronologique (les plus récentes en premier). Les formats de requêtes et de réponses existants ne sont pas modifiés sans préavis dans cette section ; de nouveaux champs et points de terminaison viennent s'y ajouter.

19 novembre 2026

  • Nouveau : essais asynchrones : la requête POST /api/v1/generations renvoie immédiatement une tâche ; vous pouvez la consulter via GET /api/v1/generations/:id. Documentation
  • Nouveau : lots pouvant contenir jusqu'à 500 essais à partir d'URL d'images : POST /api/v1/batches, GET et DELETE /api/v1/batches/:id (les articles annulés sont remboursés). Documentation
  • Nouveau : webhooks signés generation.completed, generation.failed et batch.completed, par requête (webhook_url) ou en tant que point de terminaison de compte avec sélection d'événements et événement de test dans Clés API > Webhooks. Documentation
  • Nouveau : la requête GET /api/v1/results/:id permet de télécharger un résultat enregistré associé à votre clé. Les résultats asynchrones sont conservés pendant 7 jours.
  • Nouveau : la commande DELETE /api/v1/customers/:customer_id efface les résultats et les enregistrements stockés d'un utilisateur final. Le paramètre customer_id est accepté dans les commandes /generate, /generations et les éléments de traitement par lots. Documentation
  • Nouveauté : limite de crédit mensuelle et date d'expiration par clé, définies lors de la création de la clé. Dépassement de la limite : 402 KEY_LIMIT_REACHED. Documentation
  • Nouveau : mode test (?mock=true) pour les tâches asynchrones et les traitements par lots (jusqu'à 10 éléments), gratuit.
  • Plus rapide : l'analyse du vêtement est mise en cache pendant 30 jours ; ainsi, lorsque vous essayez à nouveau le même produit à partir de la même photo, le temps de chargement est réduit d'environ 2 secondes.
  • Tableau de bord : recherche par génération à l'aide de l'identifiant client ou de l'identifiant de demande, filtre par période, affichage en temps réel et exportation au format CSV. La vue d'ensemble affiche le temps médian et le temps p95, ainsi que l'autonomie financière.
  • Sécurité : les webhooks sont envoyés uniquement vers des adresses publiques vérifiées au moment de la connexion ; ils ne suivent jamais les redirections.

18 novembre 2026

  • Nouveau : en-tête Idempotency-Key sur la requête POST /api/v1/generate ; les tentatives de reconnexion ne sont jamais facturées deux fois. Documentation
  • Nouveauté : l'en-tête X-Request-Id dans chaque réponse (et le champ request_id dans le corps des messages d'erreur), ainsi que les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining.
  • Nouveau : spécification OpenAPI 3.1 disponible à l'adresse https://www.tryoncloud.com/api/v1/openapi.json.
  • Nouveau : les indicateurs de service public sont disponibles à l'adresse GET /api/v1/status et sur la page d'état.
  • Documentation : résolution de sortie indiquée : environ 1 mégapixel (classe 1K).

14 novembre 2026

  • Nouveau : en-tête Webhook x-tryoncloud-signature-v2, qui signe l'horodatage ainsi que le corps du message afin de permettre le rejet des anciennes livraisons. L'en-tête x-tryoncloud-signature reste inchangé. Documentation
  • Modification : les limites de débit sont désormais appliquées sur tous les serveurs, avec une limite globale par compte de 600 requêtes de génération par minute et une limite distincte pour le mode test. Documentation
  • Nouveau : GET /api/v1/credits pour vérifier le nombre d'essais restants avec votre clé API. Documentation
  • Nouveau : serveur MCP à l'adresse https://www.tryoncloud.com/api/mcp pour Claude Code, Cursor et VS Code. Documentation
  • Nouveau : JavaScript/TypeScript SDK. Documentation
  • Nouveau : mode test gratuit, ?mock=true ou X-Mock: true. Documentation
  • Nouveau : DELETE /api/v1/results/:id pour supprimer prématurément un résultat enregistré. Documentation
  • Modification : le tarif « Enterprise » (à partir de 5 000 essais) passe de 0,08 $ à 0,07 $. En Inde, il reste à 6,50 ₹.
  • Modification : les téléchargements via garment_url sont désormais vérifiés à chaque redirection et au moment de la connexion ; les adresses internes, privées et de métadonnées cloud sont refusées.
  • Documents : nouveaux documents de plusieurs pages comprenant des versions au format Markdown de chaque page, un accord de traitement des données et une autorisation de revente figurant dans les Conditions générales.

12 novembre 2026

  • Modification : nouveaux tarifs pour chaque tranche : à partir de 50, 0,11 $ ; à partir de 300, 0,10 $ ; à partir de 1 000, 0,09 $ ; à partir de 5 000, 0,08 $.
  • Nouveauté : clés API nommées, jusqu'à 5 clés actives, dates de dernière utilisation, révocation une par une.

5 novembre 2026

  • Modification : la requête POST /generate renvoie désormais systématiquement le format image/png, conformément au Content-Type indiqué dans la documentation.