API

API PDF na EPUB

API EpubCC převádí PDF na EPUB 3 se stejným enginem jako tento web. Vytvořte klíč ve svém účtu, pošlete PDF na POST /v1/conversions a stáhněte EPUB, když je úloha hotová; stránky se odečítají z měsíčního limitu vašeho plánu, začínajíc 100 bezplatnými stránkami měsíčně.

Aktualizováno: 5. listopadu 2026

Jak to funguje

Vytvořte klíč ve svém účtu (je zobrazen pouze jednou; uchováváme pouze hash). Posílejte ho jako Authorization: Bearer <key> na https://api.epubcc.com.
POST /v1/conversions s PDF jako file (multipart, až 10 MB na požadavek) a volitelně paginas (1-5,9), webhook_url a hlavička Idempotency-Key, aby opakování nikdy nevytvářelo dvě úlohy.
GET /v1/conversions/{id}: stav (en_cola, procesando, completado, fallido, cancelado), pozice ve frontě, odhad doby, počty stran a zpráva o kvalitě.
GET /v1/conversions/{id}/download: podepsaný odkaz na EPUB, platný po dobu 30 minut.
DELETE /v1/conversions/{id}: zruší úlohu a současně odstraní PDF a EPUB.
Větší PDF: POST /v1/uploads otevře pokračující nahrávání (8 MB části s PATCH a Upload-Offset), poté POST /v1/conversions s {"subida": "<upload id>"}.

Stránky a limity

Každá konverze využívá stránky, které převádí z měsíčního limitu vašeho plánu, sdíleného se stránkami: Bezplatný 100, Pro 1 500, Business 6 000.
Stránky se počítají pouze tehdy, když konverze proběhne úspěšně. Neúspěšná nebo zrušená úloha nic nepoužívá.
Na soubor: až 300 stránek a 50 MB na bezplatném plánu, 1 000 stránek a 100 MB na plánu Pro, 2 000 stránek a 200 MB na plánu Business. Práce plánu Business jdou jako první do fronty, pak Pro, pak Free.
Maximálně 5 převodů probíhajících na účet; chyba 429 demasiados_trabajos nad tento počet.

Webhooky

S webhook_url posíláme úlohu (stejný JSON jako GET /v1/conversions/{id}), když se dokončí, a pokoušíme se to zopakovat 5krát. Hlavička X-EPUBLab-Firma je t=<unix time>,v1=<hex HMAC-SHA256> z <t>.<body> s tajemstvím webhooku vašeho klíče, zobrazeným vedle klíče ve vašem účtu.

Chyby

Vždy JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Kód je stabilní pro stroje a zpráva je v angličtině. Nejběžnější: no_autorizado (401), cuota_agotada a demasiadas_paginas (402), demasiado_grande (413), no_es_pdf a paginas_invalidas (400), pdf_cifrado a pdf_ilegible (422).

Vaše soubory

Stejná politika pro mazání jako na webové stránce: PDF je smazán, když je celá kniha převedena nebo 2 hodiny po posledním převodu, EPUB 1 hodinu po prvním stažení nebo 24 hodin po jejím dokončení. Nikdy publikováno, nikdy použito pro školení.

Získejte API klíč

Bezplatně s jakýmkoli účtem: 100 stránek měsíčně na bezplatném plánu, více na Pro a Business.

Zaregistrujte se a vytvořte klíč

Převeďte 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=…"}

Otázky nebo větší objem: kontaktujte nás.

Sdílet