API

PDF'dan EPUB API

EpubCC API, PDF'leri bu web sitesinin aynı motoruyla EPUB 3'ye dönüştürür. Hesabınızda bir anahtar oluşturun, /v1/conversions'a bir PDF gönderin ve iş tamamlandığında EPUB'yi indirin; sayfalar, her ay 100 ücretsiz sayfa ile başlayarak, planınızın aylık kotasından düşer.

Güncellendi: 05 Kasım 2026

Nasıl çalışır

Hesabınızda bir anahtar oluşturun (bir kez gösterilir; sadece bir hash tutarız). Bunu Authorization: Bearer <key> olarak https://api.epubcc.com'ye gönderin.
POST /v1/conversions ile PDF olarak file (çok parçalı, talep başına 10 MB'a kadar) ve isteğe bağlı olarak paginas (1-5,9), webhook_url ve bir Idempotency-Key başlığı ile böylece bir yeniden deneme iki iş oluşturmuyor.
GET /v1/conversions/{id}: durum (en_cola, procesando, completado, fallido, cancelado), kuyruk pozisyonu, tahmini zaman, sayfa sayıları ve kalite raporu.
GET /v1/conversions/{id}/download: EPUB için 30 dakika geçerli olan imzalı bir bağlantıdır.
DELETE /v1/conversions/{id}: görevi iptal eder ve PDF ile EPUB'yi aynı anda siler.
Daha büyük PDF'ler: POST /v1/uploads kesintisiz bir yükleme açar (8 MB parçalar PATCH ve Upload-Offset ile), ardından POST /v1/conversions {"subida": "<upload id>"} ile.

Sayfalar ve limitler

Her dönüşüm, planınızın aylık kotasından dönüştürdüğü sayfaları kullanır, web sitesi ile paylaşılır: Ücretsiz 100, Pro 1,500, İşletme 6,000.
Sayfalar yalnızca bir dönüşüm başarılı olduğunda sayılır. Başarısız veya iptal edilen bir iş hiçbir şey kullanmaz.
Her dosya için: 300 sayfaya kadar ve 50 MB Ücretsiz, 1,000 sayfaya kadar ve 100 MB Pro, 2,000 sayfaya kadar ve 200 MB Business. Business işler sıralamada önceliklidir, sonra Pro, sonra Ücretsiz.
Her hesap için en fazla 5 dönüşüm devam ediyor; bu sayının üstünde hata 429 demasiados_trabajos.

Webhook'lar

webhook_url ile, iş bittiğinde, aynı JSON olarak GET /v1/conversions/{id}'yi POST ediyoruz ve 5 kez tekrar deniyoruz. X-EPUBLab-Firma başlığı, hesabınızdaki anahtarın yanındaki webhook sırrınızla birlikte t=<unix time>,v1=<hex HMAC-SHA256>'nin <t>.<body>'sidir.

Hatalar

Her zaman JSON: {"error": {"codigo": "…", "mensaje": "…"}}. Kod makineler için kararlıdır ve mesaj İngilizce'dir. En yaygın olanlar: no_autorizado (401), cuota_agotada ve demasiadas_paginas (402), demasiado_grande (413), no_es_pdf ve paginas_invalidas (400), pdf_cifrado ve pdf_ilegible (422).

Dosyalarınız

Web sitesi ile aynı silme politikası: PDF, tüm kitap dönüştürüldüğünde veya son dönüştürmeden 2 saat sonra silinir, EPUB ilk indirmeden 1 saat sonra veya hazır olduğunda 24 saat sonra silinir. Hiç yayınlanmaz, eğitim için asla kullanılmaz.

Bir API anahtarı alın

Herhangi bir hesapla ücretsiz: Ücretsiz planda ayda 100 sayfa, Pro ve İş planlarında daha fazlası.

Kaydol ve bir anahtar oluştur

Bir PDF'yi dönüştür

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

Sorular veya daha fazla hacim: bizimle iletişime geçin.

Paylaş