Modalità API: Direct e Preflight

Gli endpoint API dei tools supportano due modalità operative, specificate nel path tramite il parametro {mode}.

Direct

POST /api/v1/tools/modes/direct/{tool}

Restituisce direttamente il contenuto binario del file generato (immagine, SVG o PDF) con gli header Content-Type e Content-Disposition appropriati.

Ideale per download diretto o embedding in applicazioni.

Preflight

POST /api/v1/tools/modes/preflight/{tool}

Restituisce una risposta JSON contenente un token e un URL per visualizzare il risultato nel viewer integrato (/tools/viewer?token=...).

Ideale per integrazioni che necessitano di mostrare un'anteprima prima del download.

Viewer

Il viewer (/tools/viewer) mostra un'anteprima SVG del risultato e permette il download nei formati disponibili:

• Barcode: svg, png, jpg, pdf
• QR Code: svg, png, pdf