# Registro delle modifiche dell'API

Modifiche all'API per sviluppatori, in ordine cronologico (dalle più recenti alle più vecchie). I formati esistenti delle richieste e delle risposte non subiscono modifiche senza preavviso in questa sezione; a questi si aggiungono nuovi campi e endpoint.

## 19 novembre 2026

- **Novità:** prove asincrone: `POST /api/v1/generations` restituisce immediatamente un’attività; è possibile consultarla all’indirizzo `GET /api/v1/generations/:id`. [Documentazione](/docs/async)
- **Novità:** lotti fino a 500 prove di abbigliamento da URL di immagini: `POST /api/v1/batches`, `GET` e `DELETE /api/v1/batches/:id` (gli articoli annullati vengono rimborsati). [Documentazione](/docs/async#batches)
- **Novità:** webhook firmati `generation.completed`, `generation.failed` e `batch.completed`, per richiesta (`webhook_url`) o come endpoint dell'account con selezione degli eventi e un evento di prova in **Chiavi API > Webhook**. [Documentazione](/docs/async#webhooks)
- **Novità:** `GET /api/v1/results/:id` consente di scaricare un risultato salvato associato alla propria chiave. I risultati asincroni vengono conservati per 7 giorni.
- **Novità:** il comando `DELETE /api/v1/customers/:customer_id` cancella i risultati e i record memorizzati relativi a un singolo utente finale. Il parametro `customer_id` è supportato nelle operazioni `/generate`, `/generations` e nelle operazioni in batch. [Documentazione](/docs/async#delete-a-customers-data)
- **Novità:** limite di credito mensile e data di scadenza per ogni chiave, impostati al momento della creazione della chiave. Superamento del limite: `402 KEY_LIMIT_REACHED`. [Documentazione](/docs/limits)
- **Novità:** modalità di prova (`?mock=true`) per i processi asincroni e i batch (fino a 10 elementi), gratuita.
- **Più veloce:** l'analisi del capo viene memorizzata nella cache per 30 giorni, quindi quando si ripete la prova dello stesso prodotto si risparmiano circa 2 secondi.
- **Dashboard:** ricerca per generazioni in base all’ID cliente o all’ID richiesta, filtro per periodo, visualizzazione in tempo reale ed esportazione in formato CSV. La panoramica mostra il tempo mediano e il tempo al 95° percentile, oltre alla durata residua del credito.
- **Sicurezza:** i webhook vengono inviati solo a indirizzi pubblici verificati al momento della connessione, senza mai seguire i reindirizzamenti.

## 18 novembre 2026

- **Novità:** intestazione `Idempotency-Key` nell'`POST /api/v1/generate`; i tentativi non vengono mai addebitati due volte. [Documentazione](/docs/generate#retries-and-idempotency)
- **Novità:** `X-Request-Id` in ogni risposta (e `request_id` nei corpi delle risposte di errore), oltre a `X-RateLimit-Limit` e `X-RateLimit-Remaining`.
- **Novità:** specifica OpenAPI 3.1 all'indirizzo `https://www.tryoncloud.com/api/v1/openapi.json`.
- **Novità:** dati relativi al servizio pubblico disponibili all'indirizzo `GET /api/v1/status` e nella [pagina di stato](/status).
- **Documentazione:** risoluzione di uscita dichiarata: circa 1 megapixel (classe 1K).

## 14 novembre 2026

- **Novità:** l'intestazione webhook `x-tryoncloud-signature-v2`, che firma il timestamp insieme al corpo del messaggio, in modo che le consegne non conformi possano essere rifiutate. L'intestazione `x-tryoncloud-signature` rimane invariata. [Documentazione](/docs/webhook)
- **Modifica:** i limiti di frequenza vengono ora applicati su tutti i server, con un limite a livello di account di 600 richieste di generazione al minuto e un limite separato per la modalità di prova. [Documentazione](/docs/limits)
- **Novità:** `GET /api/v1/credits` per verificare il numero di prove rimanenti con la tua chiave API. [Documentazione](/docs/credits)
- **Novità:** server MCP all'indirizzo `https://www.tryoncloud.com/api/mcp` per Claude Code, Cursor e VS Code. [Documentazione](/docs/mcp)
- **Novità:** JavaScript/TypeScript SDK. [Documentazione](/docs/sdk)
- **Novità:** modalità di prova gratuita, `?mock=true` o `X-Mock: true`. [Documentazione](/docs/generate)
- **Novità:** `DELETE /api/v1/results/:id` per cancellare anticipatamente un risultato salvato. [Documentazione](/docs/delete-result)
- **Modifica:** il prezzo per le aziende (5.000+ prove) è stato ridotto da 0,08 $ a 0,07 $. In India rimane a 6,50 ₹.
- **Modifica:** i download relativi a `garment_url` vengono ora controllati ad ogni reindirizzamento e al momento della connessione; gli indirizzi interni, privati e relativi ai metadati cloud vengono rifiutati.
- **Documentazione:** nuovi documenti multipagina con versioni in Markdown di ogni pagina, un [Accordo sul trattamento dei dati](/dpa) e un’autorizzazione alla rivendita inclusa nei [Termini](/terms#developer-api).

## 12 novembre 2026

- **Modificato:** nuovi prezzi per ogni fascia: 50+ 0,11 $, 300+ 0,10 $, 1.000+ 0,09 $, 5.000+ 0,08 $.
- **Novità:** chiavi API con nome, fino a 5 attive, date dell'ultimo utilizzo, revoca una alla volta.

## 5 novembre 2026

- **Modificato:** `POST /generate` restituisce sempre `image/png`, in linea con il `Content-Type` documentato.
