Search docs

Search the TryOnCloud API docs

Guide

Registro delle modifiche dell'API

Tutte le modifiche apportate all'API per sviluppatori, in ordine cronologico (dalle più recenti alle più vecchie).

Gli esempi di codice, gli endpoint e i codici di errore sono gli stessi in ogni linguaggio.

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
  • 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
  • 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
  • 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
  • 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
  • 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
  • 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.
  • 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
  • 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
  • Novità: GET /api/v1/credits per verificare il numero di prove rimanenti con la tua chiave API. Documentazione
  • Novità: server MCP all'indirizzo https://www.tryoncloud.com/api/mcp per Claude Code, Cursor e VS Code. Documentazione
  • Novità: JavaScript/TypeScript SDK. Documentazione
  • Novità: modalità di prova gratuita, ?mock=true o X-Mock: true. Documentazione
  • Novità: DELETE /api/v1/results/:id per cancellare anticipatamente un risultato salvato. Documentazione
  • 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 e un’autorizzazione alla rivendita inclusa nei Termini.

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.