# Journal des modifications de l'API

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](/docs/async)
- **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](/docs/async#batches)
- **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](/docs/async#webhooks)
- **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](/docs/async#delete-a-customers-data)
- **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](/docs/limits)
- **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](/docs/generate#retries-and-idempotency)
- **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](/status).
- **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](/docs/webhook)
- **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](/docs/limits)
- **Nouveau :** `GET /api/v1/credits` pour vérifier le nombre d'essais restants avec votre clé API. [Documentation](/docs/credits)
- **Nouveau :** serveur MCP à l'adresse `https://www.tryoncloud.com/api/mcp` pour Claude Code, Cursor et VS Code. [Documentation](/docs/mcp)
- **Nouveau :** JavaScript/TypeScript SDK. [Documentation](/docs/sdk)
- **Nouveau :** mode test gratuit, `?mock=true` ou `X-Mock: true`. [Documentation](/docs/generate)
- **Nouveau :** `DELETE /api/v1/results/:id` pour supprimer prématurément un résultat enregistré. [Documentation](/docs/delete-result)
- **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](/dpa) et une autorisation de revente figurant dans les [Conditions générales](/terms#developer-api).

## 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.
