API

PDF a EPUB API

L'API EpubCC converte i PDF in EPUB 3 con lo stesso motore di questo sito web. Crea una chiave nel tuo account, invia un PDF a POST /v1/conversions e scarica il EPUB quando il lavoro è completato; le pagine escono dalla tua quota mensile, partendo con 100 pagine gratuite al mese.

Aggiornato: 05 Novembre 2026

Come funziona

Crea una chiave nel tuo account (viene mostrata una sola volta; conserviamo solo un hash). Inviarla come Authorization: Bearer <key> a https://api.epubcc.com.
POST /v1/conversions con il PDF come file (multipart, fino a 10 MB per richiesta) e, facoltativamente, paginas (1-5,9), webhook_url e un'intestazione Idempotency-Key in modo che una ripetizione non crei mai due lavori.
GET /v1/conversions/{id}: lo stato (en_cola, procesando, completado, fallido, cancelado), la posizione nella coda, una stima del tempo, conteggi di pagine e il rapporto di qualità.
GET /v1/conversions/{id}/download: un link firmato al EPUB, valido per 30 minuti.
DELETE /v1/conversions/{id}: annulla il lavoro e cancella il PDF e il EPUB contemporaneamente.
PDF più grandi: POST /v1/uploads apre un upload riprendibile (chunk di 8 MB con PATCH e Upload-Offset), poi POST /v1/conversions con {"subida": "<upload id>"}.

Pagine e limiti

Each conversion uses the pages it converts from your plan's monthly allowance, shared with the website: Free 100, Pro 1,500, Business 6,000.
Le pagine vengono conteggiate solo quando una conversione ha successo. Un lavoro fallito o annullato non usa nulla.
Per file: up to 300 pages and 50 MB on Free, 1,000 pages and 100 MB on Pro, 2,000 pages and 200 MB on Business. Business jobs go first in the queue, then Pro, then Free.
Fino a 5 conversioni in corso per account; errore 429 demasiados_trabajos oltre a quello.

Webhook

Con webhook_url, inviamo il lavoro (lo stesso JSON di GET /v1/conversions/{id}) quando termina, e riproviamo 5 volte. L'intestazione X-EPUBLab-Firma è t=<unix time>,v1=<hex HMAC-SHA256> di <t>.<body> con il segreto del webhook della tua chiave, mostrato accanto alla chiave nel tuo account.

Errori

Sempre JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Il codice è stabile per le macchine e il messaggio è in inglese. I più comuni: no_autorizado (401), cuota_agotada e demasiadas_paginas (402), demasiado_grande (413), no_es_pdf e paginas_invalidas (400), pdf_cifrado e pdf_ilegible (422).

I tuoi file

La stessa politica di cancellazione del sito web: il PDF viene eliminato quando l'intero libro è convertito o 2 ore dopo l'ultima conversione, il EPUB 1 ora dopo il primo download o 24 ore dopo che è pronto. Mai pubblicato, mai utilizzato per l'addestramento.

Ottieni una chiave API

Gratuito con qualsiasi account: 100 pagine al mese sul piano Gratuito, di più su Pro e Business.

Registrati e crea una chiave

Converti un PDF

curl https://api.epubcc.com/v1/conversions \
  -H "Authorization: Bearer $EPUBCC_KEY" \
  -H "Idempotency-Key: my-book-1" \
  -F file=@book.pdf
# → 201 {"id": "…", "estado": "en_cola", "posicion": 1, …}

curl https://api.epubcc.com/v1/conversions/$ID \
  -H "Authorization: Bearer $EPUBCC_KEY"
# → {"estado": "completado", "paginas_convertidas": 120, "informe": {…}}

curl https://api.epubcc.com/v1/conversions/$ID/download \
  -H "Authorization: Bearer $EPUBCC_KEY"
# → {"url": "https://api.epubcc.com/d/…?exp=…&sig=…"}

Domande o più volume: contattaci.