API

PDF naar EPUB API

De EpubCC API converteert PDF's naar EPUB 3 met dezelfde engine als deze website. Maak een sleutel aan in je account, stuur een PDF naar POST /v1/conversions en download de EPUB wanneer de taak is voltooid; pagina's komen uit het maandelijkse quotum van je plan, te beginnen met 100 gratis pagina's per maand.

Bijgewerkt: 5 november 2026

Hoe het werkt

Maak een sleutel aan in je account (deze wordt eenmaal weergegeven; we bewaren alleen een hash). Stuur deze als Authorization: Bearer <key> naar https://api.epubcc.com.
POST /v1/conversions met de PDF als file (meerdere delen, tot 10 MB per verzoek) en, optioneel, paginas (1-5,9), webhook_url en een Idempotency-Key koptekst zodat een herhaling nooit twee taken creëert.
GET /v1/conversions/{id}: de status (en_cola, procesando, completado, fallido, cancelado), de wachtrijpositie, een tijds schatting, pagina telling en het kwaliteitsrapport.
GET /v1/conversions/{id}/download: een ondertekende link naar de EPUB, geldig voor 30 minuten.
DELETE /v1/conversions/{id}: annuleert de taak en verwijdert de PDF en de EPUB tegelijk.
Grotere PDF's: POST /v1/uploads opent een hervatbare upload (8 MB chunks met PATCH en Upload-Offset), daarna POST /v1/conversions met {"subida": "<upload id>"}.

Pagina's en limieten

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.
Pagina's worden alleen geteld wanneer een conversie slaagt. Een mislukte of geannuleerde taak gebruikt niets.
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.
Tot 5 conversies in uitvoering per account; fout 429 demasiados_trabajos boven dat aantal.

Webhooks

Met webhook_url, POSTen we de taak (dezelfde JSON als GET /v1/conversions/{id}) wanneer deze is voltooid, en proberen we het 5 keer opnieuw. De X-EPUBLab-Firma header is t=<unix time>,v1=<hex HMAC-SHA256> van <t>.<body> met het webhook-geheim van jouw sleutel, weergegeven naast de sleutel in jouw account.

Fouten

Altijd JSON: {"error": {"codigo": "…", "mensaje": "…"}}. De code is stabiel voor machines en de boodschap is in het Engels. De meest voorkomende: no_autorizado (401), cuota_agotada en demasiadas_paginas (402), demasiado_grande (413), no_es_pdf en paginas_invalidas (400), pdf_cifrado en pdf_ilegible (422).

Je bestanden

Hetzelfde verwijderbeleid als de website: de PDF wordt verwijderd wanneer het hele boek is geconverteerd of 2 uur na de laatste conversie, de EPUB 1 uur na de eerste download of 24 uur nadat het gereed is. Nooit gepubliceerd, nooit gebruikt voor training.

Krijg een API-sleutel

Gratis met elk account: 100 pagina's per maand op het Free-plan, meer op Pro en Business.

Aanmelden en een sleutel aanmaken

Converteer een 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=…"}

Vragen of meer volume: neem contact met ons op.

Deel