Spring til indhold
API

PDF til EPUB API

Det EpubCC API konverterer PDF'er til EPUB 3 med den samme motor som denne hjemmeside. Opret en nøgle i din konto, send en PDF til POST /v1/conversions, og download EPUB når opgaven er færdig; sider tælles fra din plans månedlige kvote, startende med 100 gratis sider om måneden.

Opdateret:

Hvordan det fungerer

  • Opret en nøgle i din konto (den bliver kun vist én gang; vi opbevarer kun en hash). Send den som Authorization: Bearer <key> til https://api.epubcc.com.
  • POST /v1/conversions med PDF som file (multipart, op til 10 MB pr. anmodning) og, valgfrit, paginas (1-5,9), webhook_url og en Idempotency-Key header, så et genforsøg aldrig opretter to opgaver.
  • GET /v1/conversions/{id}: tilstanden (en_cola, procesando, completado, fallido, cancelado), køposition, en tidsestimat, sideantal og kvalitetsrapport.
  • GET /v1/conversions/{id}/download: et signeret link til EPUB, gyldigt i 30 minutter.
  • DELETE /v1/conversions/{id}: annullerer opgaven og sletter PDF og EPUB på én gang.
  • Større PDF'er: POST /v1/uploads åbner en resumérbar upload (8 MB stykker med PATCH og Upload-Offset), derefter POST /v1/conversions med {"subida": "<upload id>"}.

Sider og grænser

  • Each conversion uses the pages it converts from your plan's monthly allowance, shared with the website: Free 100, Pro 1,500, Business 6,000.
  • Sider tælles kun, når en konvertering lykkes. Et fejlet eller annulleret job bruger intet.
  • 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.
  • Op til 5 konverteringer i gang pr. konto; fejl 429 demasiados_trabajos derover.

Webhooks

Med webhook_url, sender vi opgaven (den samme JSON som GET /v1/conversions/{id}) når den er færdig, og prøver 5 gange. X-EPUBLab-Firma headeren er t=<unix time>,v1=<hex HMAC-SHA256> af <t>.<body> med din nøgles webhook hemmelighed, vist ved siden af nøglens oplysninger i din konto.

Fejl

Altid JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Koden er stabil for maskiner og meddelelsen er på engelsk. De mest almindelige: 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 sletningspolitik som hjemmesiden: PDF slettes, når hele bogen er konverteret, eller 2 timer efter dens sidste konvertering; EPUB 1 time efter den første download eller 24 timer efter den er klar. Aldrig offentliggjort, aldrig brugt til træning.

Få en API-nøgle

Gratis med enhver konto: 100 sider om måneden på den gratis plan, mere på Pro og Business.

Tilmeld dig og opret en nøgle

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ørgsmål eller mere volumen: kontakt os.

PDF til EPUB værktøjer

Hvert værktøj bruger den samme motor. Op til 3 bøger om dagen er gratis.

Se alle værktøjer