API

PDF til EPUB API

EpubCC API konverterer PDF-er til EPUB 3 med samme motor som dette nettstedet. Opprett en nøkkel i kontoen din, send et PDF til POST /v1/conversions og last ned EPUB når jobben er fullført; sider trekkes fra din månedsgrense, startet med 100 gratis sider per måned.

Oppdatert: 5. november 2026

Hvordan det fungerer

Opprett en nøkkel i kontoen din (den vises kun én gang; vi beholder kun en hash). Send den som Authorization: Bearer <key> til https://api.epubcc.com.
POST /v1/conversions med PDF som file (multipart, opptil 10 MB per forespørsel) og, valgfritt, paginas (1-5,9), webhook_url og en Idempotency-Key header slik at et nytt forsøk aldri oppretter to jobber.
GET /v1/conversions/{id}: tilstanden (en_cola, procesando, completado, fallido, cancelado), køposisjonen, et tidsskjema, sidesummeringer og kvalitetsrapporten.
GET /v1/conversions/{id}/download: en signert lenke til EPUB, gyldig i 30 minutter.
DELETE /v1/conversions/{id}: kansellerer jobben og sletter PDF og EPUB på en gang.
Større PDF-er: POST /v1/uploads åpner en resumabel opplasting (8 MB biter med PATCH og Upload-Offset), deretter POST /v1/conversions med {"subida": "<upload id>"}.

Sider og grenser

Hver konvertering bruker sidene den konverterer fra din månedsgrense, delt med nettstedet: Gratis 100, Pro 1 500, Business 6 000.
Sider telles kun når en konvertering lykkes. En mislykket eller kansellert jobb bruker ingenting.
Per fil: opptil 300 sider og 50 MB på Gratis, 1 000 sider og 100 MB på Pro, 2 000 sider og 200 MB på Business. Business-jobber går først i køen, deretter Pro, deretter Gratis.
Opptil 5 konverteringer pågår per konto; feil 429 demasiados_trabajos over det.

Webhooks

Med webhook_url, sender vi POST-jobben (den samme JSON som GET /v1/conversions/{id}) når den er ferdig, og prøver på nytt 5 ganger. Headeren X-EPUBLab-Firma er t=<unix time>,v1=<hex HMAC-SHA256> av <t>.<body> med webhook-hemmeligheten til din nøkkel, vist ved siden av nøkkelen i kontoen din.

Feil

Alltid JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Koden er stabil for maskiner og meldingen er på engelsk. De mest vanlige: no_autorizado (401), cuota_agotada og demasiadas_paginas (402), demasiado_grande (413), no_es_pdf og paginas_invalidas (400), pdf_cifrado og pdf_ilegible (422).

Dine filer

Den samme slettepolitikken som nettstedet: PDF slettes når hele boken er konvertert eller 2 timer etter den siste konverteringen, EPUB 1 time etter første nedlasting eller 24 timer etter at den er klar. Aldri publisert, aldri brukt til trening.

Få en API-nøkkel

Gratis med hvilken som helst konto: 100 sider per måned på Gratis-planen, mer på Pro og Business.

Registrer deg og opprett en nøkkel

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

Spørsmål eller mer volum: kontakt oss.

Del