---
seo_title: Guida Rapida API di Conversione File | EnConvert
meta_desc: Converti il tuo primo file in 3 passaggi: ottieni una API key, poi chiama POST /v1/convert/url-to-pdf con cURL o Python. Esempi Node.js e upload JSON in XML inclusi.
keywords: guida rapida api conversione file, tutorial api conversione file, esempio curl url in pdf, convertire url in pdf con python, esempio api json in xml, chiave api conversione file, upload file api conversione, api rest conversione file node.js
---

# Guida rapida API di conversione file

Questa guida rapida ti accompagna nella tua prima richiesta di conversione file con l'API EnConvert, usando `/v1/convert/url-to-pdf` per acquisire una pagina web come PDF. In tre passaggi ti registri, generi una chiave API privata e invii una richiesta con cURL, Python o JavaScript. È incluso anche un esempio di upload file con `multipart/form-data` per JSON in XML. Le conversioni riuscite restituiscono un `presigned_url` per scaricare il file convertito, insieme a metadati di archiviazione e tempistiche.

## Inizia in 3 passaggi

1. **Registrati.** Crea un account su [enconvert.com](https://enconvert.com) per ottenere la tua chiave API.
2. **Ottieni la tua chiave API.** Vai alla dashboard e genera una chiave privata (`sk_...`). Copiala e conservala in modo sicuro.
3. **Effettua la tua prima richiesta.** Usa gli esempi qui sotto per convertire un file o un URL.

## Esempio: convertire un URL in PDF

Usa l'endpoint `/v1/convert/url-to-pdf` per acquisire qualsiasi pagina web come documento PDF.

### cURL

```bash
curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \
  -H "X-API-Key: YOUR_PRIVATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "direct_download": false}'
```

### Risposta

Una conversione riuscita restituisce l'URL di download, il percorso di archiviazione e i metadati:

```json
{
  "presigned_url": "https://econverter.nyc3.cdn.digitaloceanspaces.com/...",
  "object_key": "live/files/12345/url-to-pdf/example_20250202_120530123.pdf",
  "filename": "example_20250202_120530123.pdf",
  "file_size": 45678,
  "conversion_time_seconds": 3.21
}
```

- `presigned_url`: un URL temporaneo e scaricabile per il file convertito.
- `object_key`: il percorso di archiviazione del file (ad es., `live/files/12345/url-to-pdf/...`).
- `filename`: il nome del file generato.
- `file_size`: la dimensione del file convertito in byte.
- `conversion_time_seconds`: quanto tempo ha impiegato la conversione.

## Esempio: convertire un file (JSON in XML)

Carica un file da convertire usando `multipart/form-data`.

### cURL

```bash
curl -X POST https://api.enconvert.com/v1/convert/json-to-xml \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@data.json" \
  -F "direct_download=false"
```

### Risposta

```json
{
  "presigned_url": "https://econverter.nyc3.cdn.digitaloceanspaces.com/...",
  "object_key": "live/files/12345/json-to-xml/data_20250202_120530123.xml",
  "filename": "data_20250202_120530123.xml",
  "file_size": 1024,
  "conversion_time_seconds": 0.45
}
```

## Esempio in Python

Usa la libreria `requests` per convertire un URL in PDF:

```python
import requests

response = requests.post(
    "https://api.enconvert.com/v1/convert/url-to-pdf",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"url": "https://example.com"}
)

result = response.json()
pdf = requests.get(result["presigned_url"]).content

with open("output.pdf", "wb") as f:
    f.write(pdf)

```

## Esempio in JavaScript (Node.js)

Usa l'API `fetch` integrata (Node.js 18+) o qualsiasi client HTTP:


```javascript
const fs = require("fs");

const formData = new FormData();
formData.append("file", new Blob([fs.readFileSync("input.json")]), "input.json");
formData.append("direct_download", "true");

const response = await fetch("https://api.enconvert.com/v1/convert/json-to-xml", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: formData,
});

const buffer = Buffer.from(await response.arrayBuffer());
fs.writeFileSync("output.xml", buffer);
```

## Domande frequenti

### Come ottengo una chiave API per l'API di conversione file di EnConvert?

Crea un account su [enconvert.com](https://enconvert.com), poi vai alla dashboard e genera una chiave privata (`sk_...`). Copiala e conservala in modo sicuro. La invii a ogni richiesta nell'header `X-API-Key`.

### Come converto un URL in PDF con cURL?

Invia una richiesta `POST` a `https://api.enconvert.com/v1/convert/url-to-pdf` con la tua chiave nell'header `X-API-Key` e un corpo JSON come `{"url": "https://example.com", "direct_download": false}`. La risposta è JSON; scarica il PDF dalla `presigned_url` che contiene. Se invece imposti `direct_download` su `true`, i byte del PDF tornano nel corpo della risposta e `--output output.pdf` salva il file direttamente.

### Come carico un file per la conversione con l'API REST?

Carica il file come `multipart/form-data`, ad es. `-F "file=@data.json"` in cURL verso `/v1/convert/json-to-xml`. L'esempio Node.js fa lo stesso con `FormData` e l'API `fetch` integrata (Node.js 18+).

### Cosa contiene una risposta di conversione riuscita?

La risposta JSON include `presigned_url` (un URL temporaneo e scaricabile per il file convertito), `object_key` (il percorso di archiviazione), `filename`, `file_size` in byte, e `conversion_time_seconds`.

### Posso convertire un URL in PDF in Python?

Sì. Usa la libreria `requests` per fare `POST` a `https://api.enconvert.com/v1/convert/url-to-pdf` con l'header `X-API-Key` e un corpo JSON contenente `url`, poi leggi `presigned_url` dalla risposta JSON e scarica il file.

## Passaggi successivi

- L'[Autenticazione](/it/docs/authentication.md) copre le chiavi private, le chiavi pubbliche con JWT e come verificare le credenziali appena create.
- Gli [Endpoint](/it/docs/endpoints.md) elencano ogni rotta che puoi chiamare e i parametri che condividono.
- I [Job sincroni e asincroni](/it/docs/concepts/sync-and-async.md) spiegano quando una richiesta restituisce il risultato inline e quando ti consegna un job da interrogare in polling.