API

API PDF la EPUB

API-ul EpubCC convertește PDF-uri în EPUB 3 cu același motor ca acest site. Crează o cheie în contul tău, trimite un PDF la POST /v1/conversions și descarcă EPUB când lucrul este finalizat; paginile se scad din alocația lunară a planului tău, începând cu 100 de pagini gratuite pe lună.

Actualizat: 5 Noiembrie 2026

Cum funcționează

Creează o cheie în contul tău (este afișată o singură dată; păstrăm doar un hash). Trimite-o ca Authorization: Bearer <key> către https://api.epubcc.com.
POST /v1/conversions cu PDF ca file (multipart, până la 10 MB per cerere) și, opțional, paginas (1-5,9), webhook_url și un antet Idempotency-Key așa că o repetare nu creează niciodată două lucrări.
GET /v1/conversions/{id}: starea (en_cola, procesando, completado, fallido, cancelado), poziția în așteptare, o estimare a timpului, numărul de pagini și raportul de calitate.
GET /v1/conversions/{id}/download: un link semnat către EPUB, valabil pentru 30 de minute.
DELETE /v1/conversions/{id}: anulează lucrarea și șterge PDF și EPUB toate odată.
PDF-uri mai mari: POST /v1/uploads deschide un upload reluabil (bucăți de 8 MB cu PATCH și Upload-Offset), apoi POST /v1/conversions cu {"subida": "<upload id>"}.

Pagini și limite

Fiecare conversie folosește paginile pe care le convertește din alocația lunară a planului tău, partajată cu site-ul: Free 100, Pro 1,500, Business 6,000.
Pagini sunt numărate doar când o conversie reușește. O lucrare eșuată sau anulată nu utilizează nimic.
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.
Până la 5 conversii în curs de desfășurare per cont; eroare 429 demasiados_trabajos peste această limită.

Webhook-uri

Cu webhook_url, trimitem POST lucrarea (același JSON ca GET /v1/conversions/{id}) când aceasta se finalizează și încercăm de 5 ori. Antetul X-EPUBLab-Firma este t=<unix time>,v1=<hex HMAC-SHA256> de <t>.<body> cu secretul webhook-ului cheii tale, afișat lângă cheie în contul tău.

Erori

Întotdeauna JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Codul este stabil pentru mașini și mesajul este în engleză. Cele mai comune: 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).

Fișierele tale

Aceeași politică de ștergere ca pe site: PDF este șters când întreaga carte este convertită sau la 2 ore după ultima sa conversie, EPUB o oră după prima descărcare sau 24 de ore după ce este gata. Niciodată publicat, niciodată folosit pentru antrenament.

Obține o cheie API

Gratuit cu orice cont: 100 de pagini pe lună la planul Gratuit, mai multe la Pro și Business.

Înscrie-te și crează o cheie

Convertește 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=…"}

Întrebări sau mai mult volum: contactează-ne.

Împărtășiți