API Sviluppatori

Accesso programmatico alle conversioni server-side di Converty.

L'API v1 usa la stessa pipeline di conversione dell'app web. Serve una chiave API rilasciata per il tuo progetto.

Autenticazione

Invia la chiave API in ogni richiesta:

Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY

Endpoint

URL base: https://api.example.com

GET /v1 — Metadati API (chiave non richiesta)
POST /v1/convert/document — PDF, Word, Excel, …
POST /v1/convert/audio — audio · video · image · archive · ebook · 3d
GET /progress/:jobId — Stream Server-Sent Events
GET /download/:jobId?token=… — Download firmato
POST /import/url — Recupera file remoto (corpo JSON { "url": "…" })

Categorie: document · audio · video · image · archive · ebook · 3d

Flusso tipico

POST modulo multipart a /v1/convert/{category} con file, from, to e options JSON.
Ricevi { jobId, estimatedSeconds }.
Iscriviti a GET /progress/{jobId} (SSE) per lo stato in tempo reale.
Scarica dall'URL firmato nell'evento complete.

curl -X POST "https://api.example.com/v1/convert/document" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.pdf" \
  -F "from=pdf" \
  -F "to=docx" \
  -F 'options={}'

Limiti

Si applicano limiti di frequenza standard per IP. I file devono corrispondere a coppie di formati supportate. Vedi registro convertitori per valori from/to validi.

Servono limiti più alti o una chiave dedicata? Contattaci.