API

PDF EPUB API

EpubCC API muuntaa PDF-tiedostoja EPUB 3 muotoon samalla moottorilla kuin tämä verkkosivusto. Luo avain tililläsi, lähetä PDF osoitteeseen POST /v1/conversions ja lataa EPUB, kun työ on valmis; sivut tulevat käyttösi kuukausittaiseen kiintiöön, alkaen 100 ilmaisesta sivusta kuukaudessa.

Päivitetty: 5. marraskuuta 2026

Kuinka se toimii

Luo avain tilissäsi (se näkyy vain kerran; säilytämme vain hajautetun arvon). Lähetä se Authorization: Bearer <key>:na https://api.epubcc.com:lle.
POST /v1/conversions PDF:na file (moniosainen, enintään 10 MB per pyyntö) ja valinnaisesti paginas (1-5,9), webhook_url ja Idempotency-Key -otsikko, jotta toistokäynnistys ei koskaan luo kahta työpaikkaa.
GET /v1/conversions/{id}: tila (en_cola, procesando, completado, fallido, cancelado), jonotusasema, aikahaarukka, sivumäärät ja laaturaportti.
GET /v1/conversions/{id}/download: allekirjoitettu linkki EPUB:een, voimassa 30 minuuttia.
DELETE /v1/conversions/{id}: peruuttamatta työn ja poistamalla PDF ja EPUB kerralla.
Suuremmat PDF:t: POST /v1/uploads avaa keskeytettävän latauksen (8 MB osioina PATCH ja Upload-Offset), sitten POST /v1/conversions {"subida": "<upload id>"}:lla.

Sivut ja rajat

Jokainen muunnos käyttää sivuja, jotka se muuntaa kuukausittaisesta suunnitelmastasi, jaettuna verkkosivuston kanssa: Ilmainen 100, Pro 1 500, Business 6 000.
Sivuja lasketaan vain, kun muunnos onnistuu. Epäonnistunut tai peruutettu työpaikka ei käytä mitään.
Per tiedosto: enintään 300 sivua ja 50 MB ilmaiseksi, 1 000 sivua ja 100 MB Pro:lle, 2 000 sivua ja 200 MB Business:lle. Business-työt menevät ensin jonoon, sitten Pro, sitten Free.
Jopa 5 muunnosta käynnissä kutakin tiliä kohti; virhe 429 demasiados_trabajos yli sen.

Webhooks

Kun webhook_url on valmis, POSTaamme työn (sama JSON kuin GET /v1/conversions/{id}) ja yritämme uudelleen 5 kertaa. X-EPUBLab-Firma-otsikko on t=<unix time>,v1=<hex HMAC-SHA256> <t>.<body>:n kanssa avaimesi webhook-salaisuus, joka on näkyvissä avaimen vieressä tililläsi.

Virheet

Aina JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Koodi on vakaa koneita varten ja viesti on englanniksi. Yleisimpiä: no_autorizado (401), cuota_agotada ja demasiadas_paginas (402), demasiado_grande (413), no_es_pdf ja paginas_invalidas (400), pdf_cifrado ja pdf_ilegible (422).

Tiedostosi

Sama poistokäytäntö kuin verkkosivustolla: PDF poistetaan, kun koko kirja on muunnettu tai 2 tuntia sen viimeisen muunnoksen jälkeen, EPUB 1 tunnin kuluttua ensimmäisestä latauksesta tai 24 tuntia sen jälkeen, kun se on valmis. Ei koskaan julkaistu, ei koskaan käytetty koulutuksessa.

Hanki API-avain

Ilmainen kaikilla tileillä: 100 sivua kuukaudessa ilmaisessa suunnitelmassa, enemmän Pro- ja Business-suunnitelmissa.

Rekisteröidy ja luo avain

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

Kysymyksiä tai suurempaa määrää: ota meihin yhteyttä.

Jaa