API

PDF σε EPUB API

Η API EpubCC μετατρέπει τα PDFs σε EPUB 3 με τον ίδιο κινητήρα όπως αυτή η ιστοσελίδα. Δημιούργησε ένα κλειδί στον λογαριασμό σου, στείλε ένα PDF στο POST /v1/conversions και κατέβασε το EPUB μόλις ολοκληρωθεί η εργασία; οι σελίδες αφαιρούνται από την μηνιαία χρέωση του προγράμματός σου, ξεκινώντας με 100 δωρεάν σελίδες το μήνα.

Ενημερωμένο: 05/11/2026

Πώς λειτουργεί

Δημιουργήστε ένα κλειδί στον λογαριασμό σας (εμφανίζεται μία φορά, διατηρούμε μόνο ένα hash). Στείλτε το ως Authorization: Bearer <key> στο https://api.epubcc.com.
POST /v1/conversions με το PDF ως file (multipart, έως 10 MB ανά αίτηση) και, προαιρετικά, paginas (1-5,9), webhook_url και μια κεφαλίδα Idempotency-Key έτσι ώστε μια επανεκτέλεση να μην δημιουργεί δύο έργα.
GET /v1/conversions/{id}: η κατάσταση (en_cola, procesando, completado, fallido, cancelado), η θέση στην ουρά, μια εκτίμηση χρόνου, μετρήσεις σελίδων και η αναφορά ποιότητας.
GET /v1/conversions/{id}/download: ένας υπογεγραμμένος σύνδεσμος προς το EPUB, έγκυρος για 30 λεπτά.
DELETE /v1/conversions/{id}: ακυρώνει το έργο και διαγράφει το PDF και το EPUB ταυτόχρονα.
Μεγαλύτερα PDF: POST /v1/uploads ανοίγει μια επαναλαμβανόμενη ανέβασμα (8 MB κομμάτια με PATCH και Upload-Offset), στη συνέχεια POST /v1/conversions με {"subida": "<upload id>"}.

Σελίδες και όρια

Κάθε μετατροπή χρησιμοποιεί τις σελίδες που μετατρέπει από την μηνιαία επιδότηση του σχεδίου σου, που μοιράζεται με την ιστοσελίδα: Δωρεάν 100, Pro 1,500, Επιχειρηματική 6,000.
Οι σελίδες μετρώνται μόνο όταν μια μετατροπή είναι επιτυχής. Μια αποτυχημένη ή ακυρωμένη εργασία δεν χρησιμοποιεί τίποτα.
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.
Έως 5 μετατροπές σε εξέλιξη ανά λογαριασμό; σφάλμα 429 demasiados_trabajos πάνω από αυτό.

Webhooks

Με webhook_url, POST-άρε το έργο (το ίδιο JSON όπως το GET /v1/conversions/{id}) όταν τελειώσει, και δοκίμασε ξανά 5 φορές. Η κεφαλίδα X-EPUBLab-Firma είναι t=<unix time>,v1=<hex HMAC-SHA256> του <t>.<body> με το μυστικό webhook του κλειδιού σου, που εμφανίζεται δίπλα στο κλειδί στον λογαριασμό σου.

Σφάλματα

Πάντα JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Ο κωδικός είναι σταθερός για μηχανές και το μήνυμα είναι στα Αγγλικά. Τα πιο κοινά: no_autorizado (401), cuota_agotada και demasiadas_paginas (402), demasiado_grande (413), no_es_pdf και paginas_invalidas (400), pdf_cifrado και pdf_ilegible (422).

Τα αρχεία σας

Η ίδια πολιτική διαγραφής όπως η ιστοσελίδα: το PDF διαγράφεται όταν μετατραπεί ολόκληρο το βιβλίο ή 2 ώρες μετά την τελευταία του μετατροπή, το EPUB 1 ώρα μετά την πρώτη λήψη ή 24 ώρες μετά που είναι έτοιμο. Ποτέ δημοσιευμένο, ποτέ χρησιμοποιούμενο για εκπαίδευση.

Αποκτήστε ένα κλειδί API

Δωρεάν με οποιονδήποτε λογαριασμό: 100 σελίδες το μήνα στο δωρεάν πλάνο, περισσότερες στο Pro και την Επιχείρηση.

Εγγραφή και δημιουργία κλειδιού

Μετατρέψτε ένα 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=…"}

Ερωτήσεις ή περισσότερος όγκος: επικοινωνήστε μαζί μας.

Μοιραστείτε