API Documentation
Esegui nella sandbox

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 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#

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:

{
  "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#

curl -X POST https://api.enconvert.com/v1/convert/json-to-xml \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "direct_download=false"

Risposta#

{
  "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:

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:

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, 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 "[email protected]" 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 copre le chiavi private, le chiavi pubbliche con JWT e come verificare le credenziali appena create.
  • Gli Endpoint elencano ogni rotta che puoi chiamare e i parametri che condividono.
  • I Job sincroni e asincroni spiegano quando una richiesta restituisce il risultato inline e quando ti consegna un job da interrogare in polling.
← Introduction Authentication →