Ana içeriğe geç
Converty

Geliştirici API

Converty sunucu tarafı dönüştürmelerine programatik erişim.

v1 API, web uygulamasıyla aynı dönüştürme hattını kullanır. Projeniz için verilmiş bir API anahtarına ihtiyacınız var.

Kimlik doğrulama

Her istekte API anahtarınızı gönderin:

Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY

Uç noktalar

Temel URL: https://api.example.com

  • GET /v1 — API meta verileri (anahtar gerekmez)
  • POST /v1/convert/document — PDF, Word, Excel, …
  • POST /v1/convert/audio — audio · video · image · archive · ebook · 3d
  • GET /progress/:jobId — Server-Sent Events akışı
  • GET /download/:jobId?token=… — İmzalı indirme
  • POST /import/url — Uzak dosya getir (JSON gövde { "url": "…" })

Kategoriler: document · audio · video · image · archive · ebook · 3d

Tipik akış

  1. file, from, to ve options JSON ile /v1/convert/{category} adresine multipart form POST edin.
  2. { jobId, estimatedSeconds } alın.
  3. Canlı durum için GET /progress/{jobId} (SSE) abone olun.
  4. complete olayındaki imzalı URL'den indirin.
curl -X POST "https://api.example.com/v1/convert/document" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.pdf" \
  -F "from=pdf" \
  -F "to=docx" \
  -F 'options={}'

Limitler

IP başına standart hız limitleri geçerlidir. Dosyalar desteklenen format çiftleriyle eşleşmelidir. Geçerli from/to değerleri için dönüştürücü kaydına bakın.

Daha yüksek limitler veya özel anahtar mı gerekiyor? Bize ulaşın.