API

API PDF do EPUB

API EpubCC konwertuje pliki PDF na EPUB 3 za pomocą tego samego silnika co ta witryna. Utwórz klucz w swoim koncie, wyślij PDF do POST /v1/conversions i pobierz EPUB, gdy zadanie zostanie zakończone; strony wchodzą w miesięczny limit twojego planu, zaczynając od 100 darmowych stron miesięcznie.

Zaktualizowane: 5 listopada 2026

Jak to działa

Utwórz klucz w swoim koncie (jest pokazywany tylko raz; przechowujemy tylko skrót). Wyślij go jako Authorization: Bearer <key> do https://api.epubcc.com.
POST /v1/conversions z PDF jako file (multipart, do 10 MB na żądanie) oraz, opcjonalnie, paginas (1-5,9), webhook_url i nagłówek Idempotency-Key, aby ponowne próby nie tworzyły dwóch zadań.
GET /v1/conversions/{id}: stan (en_cola, procesando, completado, fallido, cancelado), pozycja w kolejce, szacowany czas, liczby stron oraz raport jakości.
GET /v1/conversions/{id}/download: podpisany link do EPUB, ważny przez 30 minut.
DELETE /v1/conversions/{id}: anuluje zadanie i usuwa PDF oraz EPUB jednocześnie.
Większe pliki PDF: POST /v1/uploads otwiera wznowienie przesyłania (8 MB kawałkami z PATCH i Upload-Offset), potem POST /v1/conversions z {"subida": "<upload id>"}.

Strony i limity

Każda konwersja wykorzystuje strony, które konwertuje, z miesięcznego limitu twojego planu, dzielonego z witryną: Darmowe 100, Pro 1 500, Biznes 6 000.
Strony są liczone tylko wtedy, gdy konwersja się powiedzie. Nieudane lub anulowane zadanie nie wykorzystuje nic.
Na plik: do 300 stron i 50 MB na Free, 1 000 stron i 100 MB na Pro, 2 000 stron i 200 MB na Business. Zlecenia Business trafiają najpierw w kolejce, potem Pro, a następnie Free.
Do 5 konwersji w toku na konto; błąd 429 demasiados_trabajos powyżej tego.

Webhooki

Z webhook_url wysyłamy POST z zadaniem (ten sam JSON co GET /v1/conversions/{id}) po zakończeniu, a następnie próbujemy 5 razy. Nagłówek X-EPUBLab-Firma to t=<unix time>,v1=<hex HMAC-SHA256> <t>.<body> z sekretem webhooka Twojego klucza, wyświetlanym obok klucza w Twoim koncie.

Błędy

Zawsze JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Kod jest stabilny dla maszyn, a komunikat jest w języku angielskim. Najczęstsze: no_autorizado (401), cuota_agotada i demasiadas_paginas (402), demasiado_grande (413), no_es_pdf i paginas_invalidas (400), pdf_cifrado i pdf_ilegible (422).

Twoje pliki

Ta sama polityka usuwania co witryna: PDF jest usuwany, gdy cała książka jest konwertowana lub 2 godziny po ostatniej konwersji, EPUB 1 godzinę po pierwszym pobraniu lub 24 godziny po tym, jak jest gotowy. Nigdy nie publikowany, nigdy nie używany do treningu.

Zdobądź klucz API

Darmowe z każdym kontem: 100 stron miesięcznie na planie Free, więcej na Pro i Biznes.

Zarejestruj się i utwórz klucz

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

Pytania lub większy wolumen: skontaktuj się z nami.

Udostępnij