Concetti#
Quattro cose valgono qualunque sia l'endpoint EnConvert che chiami: come raggiungi l'API, se una chiamata risponde inline oppure ti consegna un job da sottoporre a polling, come ti arriva il file di output e a quale metà dell'API appartiene il tuo compito. Queste quattro pagine le trattano una volta sola, così il riferimento degli endpoint può restare concentrato sugli endpoint.
Le quattro pagine#
- REST, MCP e CLI: esiste una sola API HTTP, e il server MCP, la CLI, il node n8n e i dieci SDK ne sono tutti client, autenticati dalla stessa chiave
sk_.... - Job sincroni e asincroni: alcune chiamate restituiscono il risultato finito nel corpo della risposta, altre restituiscono un id da sottoporre a polling finché non raggiunge uno stato terminale. Questa pagina indica quali endpoint fanno cosa.
- URL firmati: i file di output tornano come link di download firmati a scadenza limitata anziché come byte inline, quindi questa pagina copre la finestra di scadenza, cosa succede dopo e come ottenere invece i byte in streaming diretto.
- V1 e V2: V1 converte file e URL tra formati, V2 legge pagine web live trasformandole in dati pronti per gli agenti. Stessa chiave, stessa quota mensile, forma della richiesta diversa.
Non sai da dove iniziare#
Se non hai ancora fatto una richiesta, leggi prima la guida rapida: ti porta a una chiamata funzionante in tre passaggi. Autenticazione copre i due tipi di chiave e quando si applica ciascuno. Quando ti serve il dettaglio a livello di parametro, Endpoint è il riferimento, e Guide raccoglie i percorsi guidati per compito su upload, webhook e batch.