---
seo_title: Concetti API: superfici, job, URL firmati | EnConvert
meta_desc: Le idee dietro l'API EnConvert: le quattro superfici di accesso, i job sincroni e asincroni, gli URL di download firmati e le differenze tra V1 e V2.
keywords: concetti api enconvert, superfici di accesso api, api sincrona o asincrona, url di download firmati, differenze api v1 e v2, basi api conversione file, modello mentale api rest, polling stato job api
---

# 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](/it/docs/concepts/rest-mcp-and-cli.md)**: 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](/it/docs/concepts/sync-and-async.md)**: 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](/it/docs/concepts/signed-urls.md)**: 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](/it/docs/concepts/v1-and-v2.md)**: 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](/it/docs/quickstart.md): ti porta a una chiamata funzionante in tre passaggi. [Autenticazione](/it/docs/authentication.md) copre i due tipi di chiave e quando si applica ciascuno. Quando ti serve il dettaglio a livello di parametro, [Endpoint](/it/docs/endpoints.md) è il riferimento, e [Guide](/it/docs/guides.md) raccoglie i percorsi guidati per compito su upload, webhook e batch.
