Ücretsiz · 25 MB altı dosyalar için üyelik gerekmez · Dosyalar 1 saat sonra silinir
Ana sayfa › API başvuru belgesi

API başvuru belgesi

33 dosya aracını kendi kodunuzdan çalıştırın. Bir başlıkta tek anahtar, tek yükleme, sorgulanacak bir durum adresi — SDK gerekmez.

Temel adres https://convertavo.com/tr/api/v1
REST · JSON Sürüm v1 Bearer auth

Giriş

Convertavo API, web sitesiyle aynı dönüştürücüleri — PDF, resim, OCR ve medya araçlarını — düz HTTPS üzerinden sunar. Birkaç öngörülebilir kaynak etrafında düzenlenmiştir, multipart/form-data yüklemeleri kabul eder ve her zaman standart HTTP durum kodlarıyla JSON olarak yanıt verir.

Kimlik doğrulama

Panelinizde API anahtarları altından bir anahtar oluşturun. Anahtarlar at_ ile başlar ve bir kez gösterilir: yalnızca bir özet (hash) saklarız; bu yüzden kaybolan bir anahtar geri getirilemez — iptal edin ve yenisini oluşturun. Anahtarı her istekte gönderin:

Authorization: Bearer at_your_key_here
Anahtarları sunucuda tutun. Bir anahtara sahip olan herkes kotanızı harcayabilir. Onu asla bir mobil uygulamaya, bir tarayıcı paketine ya da herkese açık bir depoya gömmeyin — bu sayfadaki her örneğin yaptığı gibi CONVERTAVO_KEY gibi bir ortam değişkeninden okuyun.

Eksik bir anahtar 401 Missing API key, yanlış ya da iptal edilmiş bir anahtar 401 Invalid or revoked API key döndürür.

Hızlı başlangıç

Bir PDF'yi baştan sona sıkıştırın: yükleyin, işi bekleyin, sonucu kaydedin. Dilinizi seçin — seçim sayfa boyunca hatırlanır.

  1. 1
    Anahtarınızı ayarlayınCONVERTAVO_KEY ortam değişkeni olarak kaydedin.
  2. 2
    GerekenlercURL, ext-curl ile PHP, requests ile Python ya da Node.js 18+.
  3. 3
    Betiği çalıştırınYükler, her 2 saniyede bir sorgular ve indirir.
# 1. Upload — returns 202 and a status_url
curl -X POST https://convertavo.com/tr/api/v1/tools/compress-pdf/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@report.pdf" \
  -F "settings[Compression level]=Balanced (recommended)"

# 2. Poll until status is "done" or "failed"
curl https://convertavo.com/tr/api/v1/conversions/852 \
  -H "Authorization: Bearer $CONVERTAVO_KEY"

# 3. Download the signed download_url from step 2 as it is
#    (no key needed; it stops working when the file is deleted)
curl -L -o report-small.pdf "https://convertavo.com/tr/download/1814?expires=1791200000&signature=3f9a…"

Bir dönüştürme nasıl çalışır

Dönüştürmeler bir kuyrukta çalışır; bu yüzden yükleme hemen yanıt döner ve iş arka planda — genellikle saniyeler içinde — biter.

POSTYükle/tools/{key}/convert → status_url ile 202
GETSorgulaqueued → processing → done ya da failed
GETİndirdownload_url, bir saat geçerli
GET/api/v1/tools

Araçları listele

Her etkin aracı, dönüştürme uç noktasının beklediği tam ayar adlarıyla döndürür. Seçenekleri koda sabit yazmak yerine bunu kullanın. "api_supported": false olan araçlar bir linkten çalışır ve yalnızca web sitesinde kullanılabilir.

curl https://convertavo.com/tr/api/v1/tools \
  -H "Authorization: Bearer $CONVERTAVO_KEY"
Yanıt 200 OK
{
  "tools": [
    {
      "key": "compress-pdf",
      "name": "Compress PDF",
      "category": "PDF",
      "input": "file",
      "api_supported": true,
      "accepts": "PDF",
      "accepts_multiple_files": false,
      "settings": [ … ],
      "switches": [ … ]
    }
  ]
}
GET/api/v1/tools/{key}

Bir aracı getir

Anahtarına göre tek bir araç. Bilinmeyen ya da devre dışı bir araç için 404 döndürür.

Yol parametresiTürAçıklama
key zorunlustringAraç anahtarı, örn. compress-image. Araç başvurusuna bakın.
curl https://convertavo.com/tr/api/v1/tools/compress-image \
  -H "Authorization: Bearer $CONVERTAVO_KEY"
Yanıt 200 OK
{
  "key": "compress-image",
  "name": "Compress Image",
  "category": "Image",
  "input": "file",
  "api_supported": true,
  "accepts": "JPG, PNG, WebP",
  "accepts_multiple_files": true,
  "settings": [
    { "name": "Quality", "type": "range" },
    { "name": "Output format", "type": "select",
      "options": ["Keep original", "JPG", "WebP", "AVIF"] },
    { "name": "Max width", "type": "number", "example": "1920" }
  ],
  "switches": [
    { "index": 0, "name": "Strip EXIF and location data" }
  ]
}
POST/api/v1/tools/{key}/convert

Dosyaları dönüştür

Bir ya da daha fazla dosya yükler ve dönüştürmeyi kuyruğa alır. multipart/form-data gönderin. Hemen 202 Accepted ile yanıt verir; sonuç için status_url'yi izleyin.

AlanTürAçıklama
files[] zorunlufile[]İstek başına planınızın grup boyutuna kadar (Sınırlar'a bakın); daha büyük grupları bölün. Her dosya aracın kredisini tutar. Çoklu dosya desteği olmayan araçlar tek dosya alır.
settings[<name>] isteğe bağlıstringTam adıyla bir ayar, örn. settings[Output format]=WebP. Gönderilmeyen ayarlar aracın varsayılanını kullanır.
switches[<index>] isteğe bağlıbooleanKonumuna göre bir onay kutusu seçeneği; 1 açık, 0 kapalı. Gönderilmeyen anahtarlar kapalıdır.
curl -X POST https://convertavo.com/tr/api/v1/tools/compress-image/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F 'settings[Quality]=80' \
  -F 'settings[Output format]=WebP' \
  -F "switches[0]=1"
Yanıt 202 Accepted
{
    "id": 852,
    "status": "queued",
    "status_url": "https://convertavo.com/tr/api/v1/conversions/852",
    "credits_charged": 1,
    "credits_remaining": 2999
}
GET/api/v1/conversions/{id}

Bir dönüştürmeyi getir

Başlattığınız bir dönüştürmenin durumu. Başka bir hesaba ait bir dönüştürme 404 döndürür.

AlanTürAçıklama
statusenumqueued, processing, done ya da failed.
errorstring | nullfailed olduğunda: bir kişiye gösterilmesi güvenli bir cümle (İngilizce).
files[]arraydone olduğunda: name, bayt cinsinden size, download_url.
download_all_urlstringBir iş birden fazla dosya ürettiğinde: hepsi tek bir ZIP olarak.
expires_atISO 8601Çıktı dosyalarının silineceği zaman.
curl https://convertavo.com/tr/api/v1/conversions/852 \
  -H "Authorization: Bearer $CONVERTAVO_KEY"
Yanıt 200 OK
{
    "id": 852,
    "tool_key": "compress-image",
    "status": "done",
    "error": null,
    "files": [
        {
            "name": "photo.webp",
            "size": 58766,
            "download_url": "https://convertavo.com/tr/download/1814?expires=1794545640&signature=3f9a\u2026"
        }
    ],
    "expires_at": "2026-11-13T09:54:00+05:00"
}

Ayarlar ve anahtarlar

Seçenekler her aracın sayfasındaki kontrollerin aynısıdır; adlar ise o sayfaların İngilizce sürümünde gördüğünüz kelimelerdir.

  • Ayarlar etiketiyle belirtilir: settings[Compression level]=Maximum compression. Boşluklar ve noktalama adın parçasıdır; HTTP kütüphaneniz onları kodlar.
  • Seçim ayarları, büyük/küçük harf dahil, listelenen değerlerden birini tam olarak kabul eder.
  • Anahtarlar, 0'dan başlayarak konuma göre onay kutularıdır. Web sitesinde ilk anahtar işaretli başlar; API üzerinden ise siz 1 göndermedikçe her anahtar kapalıdır.
  • Bilinmeyen adlar reddedilmez, yok sayılır — bir seçeneğin etkisi yok gibi görünüyorsa yazımı Bir aracı getir ile kontrol edin.

Sınırlar ve kotalar

SınırFreeBasicStandardBusinessLifetime
Kredilergünde 50ayda 3.000ayda 10.000ayda 40.000tek seferlik 60.000
Dakika başına istek10306012060
En büyük dosya100 MB200 MB500 MB1.000 MB500 MB
İstek başına dosya10205010050
  • Dönüştürmeler, web sitesiyle aynı fiyatlarla ve aynı bakiyeden dosya başına kredi tutar: her biri 1 kredilik on resim 10 kredi tutar.
  • Sorgulama, araçları listeleme ve sonuçları indirme hiçbir şeye mal olmaz, ama her istek planınızın dakika başına istek sınırına sayılır.
  • Her dönüştürme yanıtı credits_charged ve credits_remaining içerir; böylece bir betik kendi hızını ayarlayabilir.
  • Ekip üyeleri ekibin kredilerini harcar.

Hatalar

Hatalar, insan tarafından okunabilir bir message içeren JSON gövdesi döndürür. Doğrulama hataları (422) ayrıca alana göre anahtarlanmış bir errors nesnesi içerir.

DurumAnlamıNe yapmalı
202Kabul edildi — dönüştürme kuyrukta.status_url'yi sorgulayın.
401Eksik, yanlış ya da iptal edilmiş anahtar.Authorization başlığını kontrol edin.
404Bilinmeyen araç ya da size ait olmayan bir dönüştürme.Anahtarı ya da kimliği kontrol edin.
410Dosyası silinmiş bir indirme linki.Yeniden dönüştürün.
422Dosya yok, planınızın boyut sınırını aşan bir dosya ya da yalnızca linkle çalışan bir araç.errors'u okuyun ve isteği düzeltin.
402Bu istek için yeterli kredi yok.Gövdede credits_needed, credits_remaining ve credits_reset_at vardır. Yenilenmeyi bekleyin ya da planınızı yükseltin.
429Planınız için dakikada çok fazla istek.Retry-After saniyesi kadar bekleyin, sonra yeniden deneyin.
5xxBizim tarafımızda bir şey başarısız oldu.Üstel geri çekilmeyle yeniden deneyin.
Yanıt 422 Unprocessable Content
{
  "message": "The files field is required.",
  "errors": {
    "files": ["The files field is required."]
  }
}

İndirmeler ve saklama

  • İndirme adresleri API anahtarı gerektirmez; bu yüzden birini bir tarayıcıya verebilirsiniz. Tahmin edilemezler — geçerli oldukları sürece onları gizli tutun.
  • Girdi ve çıktı dosyaları dönüştürmeden bir saat sonra silinir; sonrasında link 410 döndürür.
  • Dönüştürme kaydı (ad, boyut, durum) panel geçmişinizde kalır.

En iyi uygulamalar

Nazikçe sorgulayın2–5 saniyede bir fazlasıyla yeterlidir ve her sorgu bir API çağrısıdır. done ya da failed'da durun.
Güvenle yeniden deneyin5xx ve ağ hatalarını geri çekilmeyle yeniden deneyin. 4xx'i yeniden denemeyin — isteği düzeltin.
Hemen indirinSonuçları hazır olur olmaz kaydedin; bir saat sonra süreleri dolar.
Anahtarları değiştirinDiğerlerini bozmadan birini iptal edebilmek için uygulama ya da sunucu başına bir anahtar kullanın.

Mevcut sınırlamalar

  • Henüz webhook yok — durum adresini sorgulayın.
  • Dönüştürme geçmişi için uç nokta yok; paneli kullanın.
  • Uyumsuz değişiklikler /v2 olarak yayınlanacak; /v1 belgelendiği gibi kalır.

QR Kod API

Statik ve dinamik QR kodlar oluşturun, onları SVG, PNG, JPG, WebP ya da PDF olarak indirin, dinamik bir kodun nereye yönlendirdiğini değiştirin ve okutma istatistiklerini okuyun. Yukarıdaki her şeyle aynı anahtarı ve web sitesiyle aynı motoru kullanır: aynı içerik biçimleri, aynı tasarım kuralları ve bir kodun size verilmeden önce gerçekten okunduğuna dair aynı kontrol.

Uç noktaNe yapar
GET /api/v1/qr/typesKullanabileceğiniz türler ve her birinin aldığı alanlar.
POST /api/v1/qr/renderBir resim oluşturur ve döndürür. Hiçbir şey kaydedilmez.
POST /api/v1/qrStatik ya da dinamik bir kod kaydeder.
GET /api/v1/qrKodlarınızı listeler (mode, status, type, q, per_page).
GET · PATCH · DELETE /api/v1/qr/{id}Tek bir kodu okur, değiştirir ya da siler. id, kod oluşturulduğunda döndürülen id'dir.
GET /api/v1/qr/{id}/imageKod, bir resim dosyası olarak.
GET /api/v1/qr/{id}/analyticsOkutmalar, tekil ziyaretçiler, cihazlar, ülkeler ve daha fazlası (yalnızca dinamik).
Kendi sınırları olan bir plan özelliği. QR API, onu içeren planlarda kullanılabilir (aksi hâlde 403). Çağrılar planınızın dakika başına istek sınırına sayılır ve her anahtar dakikada 60 istekle — resim oluşturan her şey için dakikada 20 istekle — sınırlıdır. Aşmak, bir Retry-After başlığıyla 429 döndürür. Kod kaydetme ve dinamik kodlar web sitesindeki plan haklarının aynısını izler.
  • data türün alanlarını tutar. Adlar için /qr/types'a sorun — bir Wi-Fi kodu ssid, password, authentication alır; bir link url alır.
  • design isteğe bağlıdır ve her alanı doğrulanır. Renkler #rrggbb biçimindedir; güvenilir şekilde okunmayacak bir tasarım 422, scannability_score değeri ve reasons ile reddedilir.
  • Barındırılan sayfalar (kartvizit, menü, dosya sayfaları…) ve uygulama mağazası linkleri API üzerinden değil, web sitesinde yapılır.
  • Bir logo data: resmi olarak gönderilebilir; SVG logolar betiklerden temizlenir ve gerçekten resim olmayan her şey reddedilir.
  • Başkasına ait bir kod, tıpkı var olmamış gibi 404 yanıtı verir.
POST/api/v1/qr/render

QR resmi oluştur

Kodun ne söyleyeceğini gönderin; resim hemen geri gelir. format svg, png (varsayılan), jpg, webp ya da pdf'dir; size piksel cinsindendir, en fazla 2048.

curl -X POST https://convertavo.com/tr/api/v1/qr/render \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"wifi","data":{"ssid":"Guest","password":"welcome-2026","authentication":"WPA"},"design":{"dots":{"shape":"rounded","color":{"type":"solid","value":"#1e3a8a"}}},"format":"png","size":512}' \
  -o wifi.png
Yanıt 422 Unprocessable
{
  "message": "This design would not scan reliably, so it was not made.",
  "scannability_score": 40,
  "reasons": [
    "Contrast between the dots and background is too low (1.4:1, minimum 4.0:1) …"
  ]
}
POST/api/v1/qr

QR kod oluştur

mode ya static (varsayılan: veri sonsuza kadar kodun içindedir) ya da dynamic'tir (kod, sonradan yeniden yönlendirebileceğiniz bir kısa link tutar — tür, url gibi bir web adresi üretmelidir). İsteğe bağlı: name, tags, folder_id, design ve dinamik kodlar için custom_slug. 201 döndürür.

curl -X POST https://convertavo.com/tr/api/v1/qr \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"url","mode":"dynamic","name":"Spring menu","data":{"url":"https://example.com/menu"},"tags":["spring"]}'
Yanıt 201 Created
{
  "data": {
    "id": "0f6c1b52-…",
    "name": "Spring menu",
    "type": "url",
    "mode": "dynamic",
    "status": "active",
    "short_url": "https://…/q/k3d9x2p",
    "destination_url": "https://example.com/menu",
    "scannability_score": 100,
    "scan_count": 0,
    "links": {
      "self": "https://…/api/v1/qr/0f6c1b52-…",
      "image": "https://…/api/v1/qr/0f6c1b52-…/image",
      "analytics": "https://…/api/v1/qr/0f6c1b52-…/analytics"
    }
  }
}
GET/api/v1/qr PATCH/api/v1/qr/{id}

Listele, oku, güncelle, sil

PATCH; name, tags ve — dinamik kodlar için — destination (web sitesinde yazılan bir hedef gibi kontrol edilir) ve status (paused ya da active) kabul eder. Basılı kod asla değişmez. DELETE, 204 döndürür.

curl -X PATCH https://convertavo.com/tr/api/v1/qr/0f6c1b52-0000-0000-0000-000000000000 \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination":"https://example.com/summer-menu"}'
Yanıt 422 Unprocessable
{ "message": "That website is not allowed on this service." }
GET/api/v1/qr/{id}/image?format=svg&size=1024

Resim indir

Kayıtlı bir kodu saklanan tasarımından oluşturur. Dinamik bir kodun resmi kısa linkini kodlar; bu yüzden bastığınız dosyanın asla değişmesi gerekmez.

curl -X GET https://convertavo.com/tr/api/v1/qr/0f6c1b52-0000-0000-0000-000000000000/image?format=svg&size=1024 \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -o qr.svg
GET/api/v1/qr/{id}/analytics

Okutma istatistikleri

range; today, 7d, 30d (varsayılan), 90d, 365d ya da from ve to tarihleriyle custom'dur. Tüm tarihler UTC'dir. Ziyaretçiler sayılır, asla tanımlanmaz.

curl -X GET https://convertavo.com/tr/api/v1/qr/0f6c1b52-0000-0000-0000-000000000000/analytics?range=7d \
  -H "Authorization: Bearer $CONVERTAVO_KEY"
Yanıt 200 OK
{
  "data": {
    "from": "2026-09-16", "to": "2026-09-22",
    "totals": { "scans": 412, "unique": 301 },
    "delta": { "scans": 12.5, "unique": 8.1 },
    "series": [ … ],
    "breakdowns": { "device": [ … ], "country": [ … ], … }
  }
}

Fatura API

Faturalar, teklifler ve iade faturaları oluşturun, düzenleyin ve takip edin; müşterilerinizi tutun; ödemeleri kaydedin; PDF'yi ve EN 16931 ile uyumlu XML'i indirin ve bir fatura görüntülendiğinde, ödendiğinde ya da vadesi geçtiğinde kendi yazılımınıza haber verilsin. Yukarıdaki her şeyle aynı anahtarı ve Fatura Oluşturucu ile aynı motoru kullanır: aynı doğrulama, aynı toplamlar, aynı numaralandırma, aynı PDF.

Uç noktaNe yapar
POST /api/v1/invoicesBir taslak oluşturur ya da "issue": true ile hemen düzenler.
GET /api/v1/invoicesBelgeleri en yeniden başlayarak listeler (status, type, client_id, issued_from, issued_to, q).
GET · PATCH · DELETE /api/v1/invoices/{id}Bir belgeyi okur; bir taslağı değiştirir ya da siler.
POST /api/v1/invoices/{id}/issueBir taslağı düzenler: numara şimdi verilir.
POST /api/v1/invoices/{id}/paymentsBir ödeme kaydeder.
POST /api/v1/invoices/{id}/send · /cancelMüşteriye e-postayla gönderir · iptal eder.
GET /api/v1/invoices/{id}/pdfPDF.
GET /api/v1/invoices/{id}/pdf-a3 · /xml/ubl · /xml/ciiYapılandırılmış veri (faturalar ve iade faturaları).
GET · POST /api/v1/clients, GET · PATCH · DELETE /api/v1/clients/{id}Müşterileriniz.
GET /api/v1/businessesAdına fatura kestiğiniz işletmeler.
Ücretli plan özelliği. Fatura API ve webhook'ları ücretli planlarla gelir (aksi hâlde 403). Bir belge düzenlemek, tıpkı web sitesindeki gibi bir kredi harcar; taslaklar, okuma ve ödemeler ücretsizdir. Dakika başına istekler planınızı izler ve aşmak Retry-After ile 429 döndürür.
  • Tutarlar belgenin para biriminde ondalık metin olarak gönderilir — "1250.50", asla kayan noktalı sayı değil. İki kez geri gelirler: amounts içinde ondalık metin olarak ve amounts_minor içinde küçük birim cinsinden tam sayı olarak; hesaplamalar için tam sayıları kullanın. Sunucu her toplamı kendisi hesaplar; istekteki toplamlar yok sayılır.
  • Idempotency. Her POST, PATCH ya da DELETE ile bir Idempotency-Key başlığı gönderin. 24 saat içinde aynı gövdeyle aynı anahtar, Idempotent-Replayed: true olarak işaretlenmiş ilk yanıtı yeniden döndürür — yani bir bağlantı koparsa yeniden gönderin yeter. Farklı bir gövdeyle aynı anahtar 422 ile reddedilir.
  • Sayfalama imleçle yapılır: null olana kadar meta.next_cursor değerini cursor olarak geri gönderin. per_page en fazla 100 olabilir.
  • Başkasına ait bir fatura ya da müşteri, tıpkı var olmamış gibi 404 yanıtı verir.
  • Makinelerin okuyabildiği tam başvuru belgesi: bu uç noktaları sunan koddan üretilmiş OpenAPI 3.1 belgesi.
POST/api/v1/invoices

Fatura oluştur ve düzenle

Gövde, faturanın düzenleyicinin tuttuğu hâlidir: currency, lines (her biri description, quantity, unit_price, tax_rate, tax_category ile) ve isteğe bağlı olarak tarihler, buyer, seller, indirimler, kargo, notlar ve şablon. Alıcıyı kayıtlı bir müşteriden doldurmak için bir client_id, hangi işletmenizden geleceğini seçmek için bir business_id verin. "issue": true ile hemen numaralandırılır ve yanıt pdf_url değerini taşır; olmadan, değiştirebileceğiniz bir taslak olarak kalır.

curl -X POST https://convertavo.com/tr/api/v1/invoices \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue":true,"currency":"USD","issue_date":"2026-10-20","due_date":"2026-11-03","buyer":{"name":"Northwind Studio","email":"accounts@northwind.example"},"lines":[{"description":"Logo design","quantity":"1","unit_price":"450.00","tax_rate":"0","tax_category":"zero"},{"description":"Brand guidelines (hours)","quantity":"6","unit_price":"65.00","tax_rate":"0","tax_category":"zero"}],"notes":"Thank you for your business."}'
Yanıt 201 Created
{
    "data": {
        "id": "0199a2b4-7a10-71d4-8c3b-1a2b3c4d5e6f",
        "object": "invoice",
        "type": "invoice",
        "status": "partially_paid",
        "number": "INV-2026-0042",
        "business_id": 12,
        "client_id": 34,
        "client_name": "Northwind Studio",
        "currency": "USD",
        "language": "en",
        "issue_date": "2026-10-20",
        "due_date": "2026-11-03",
        "reference": "Project Kite",
        "po_number": "PO-77",
        "related_invoice_id": "0199a2b4-5d00-7e2f-a1b2-c3d4e5f60718",
        "amounts": {
            "subtotal": "840.00",
            "discount": "0.00",
            "shipping": "0.00",
            "tax": "0.00",
            "withholding": "0.00",
            "rounding": "0.00",
            "total": "840.00",
            "payable": "840.00",
            "paid": "400.00",
            "credited": "0.00",
            "balance": "440.00"
        },
        "amounts_minor": {
            "subtotal": 84000,
            "discount": 0,
            "shipping": 0,
            "tax": 0,
            "withholding": 0,
            "rounding": 0,
            "total": 84000,
            "payable": 84000,
            "paid": 40000,
            "credited": 0,
            "balance": 44000
        },
        "issued_at": "2026-10-20T09:05:00+05:00",
        "sent_at": "2026-10-20T09:06:00+05:00",
        "viewed_at": "2026-10-20T11:30:00+05:00",
        "paid_at": "2026-10-21T10:00:00+05:00",
        "cancelled_at": "2026-10-21T10:00:00+05:00",
        "pdf_url": "https://convertavo.com/api/v1/invoices/0199a2b4-7a10-71d4-8c3b-1a2b3c4d5e6f/pdf",
        "pdf_sha256": "abababababababababababababababababababababababababababababababab",
        "created_at": "2026-10-20T09:00:00+05:00",
        "updated_at": "2026-10-21T10:00:00+05:00"
    }
}

Hatalar, alan yoluna göre anahtarlanmış errors ile 422 olarak gelir — lines.1.unit_price — böylece doğru alanın yanında gösterilebilirler. Kredi kalmadıysa düzenleme 402 yanıtı verir ve taslak tutulur (draft_id).

POST/api/v1/invoices/{id}/payments

Faturalar, ödemeler, gönderme

Bir ödeme; paid_on, method ve reference ile bir amount (ondalık metin) ya da amount_minor'dur. Kendi external_id değerinizi — bir banka ya da ödeme altyapısı işlem kimliği — verin; aynı ödeme kaç kez gelirse gelsin bir kez kaydedilir. Fatura kendiliğinden partially_paid ve paid durumlarına geçer.

curl -X POST https://convertavo.com/tr/api/v1/invoices/0199a2b4-7a10-71d4-8c3b-1a2b3c4d5e6f/payments \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":"300.00","method":"bank_transfer","reference":"TRX-9921","external_id":"bank-tx-55120"}'
Yanıt 201 Created
{
  "data": { "id": 56, "object": "payment", "amount_minor": 30000, "amount": "300.00", "currency": "USD", "paid_on": "2026-10-21", "method": "bank_transfer", "reference": "TRX-9921" },
  "invoice": { "id": "0199a2b4-…", "status": "partially_paid", "amounts_minor": { "payable": 84000, "paid": 30000, "balance": 54000, … }, … }
}
  • Düzenlenmiş bir belge değiştirilemez ya da silinemez (409): web sitesinden bir iade faturasıyla düzeltin ya da hiçbir şey ödenmemiş veya iade edilmemişken iptal edin.
  • Zaten düzenlenmiş bir belgede POST …/issue onu değiştirmeden döndürür — tekrarlamak güvenlidir.
  • POST …/send müşteriye belgenin dilinde PDF'yi ve özel bir linki e-postalar; to adresi geçersiz kılar.
GET/api/v1/clients

Müşteriler

En az bir name ile oluşturun; email, address, tax_number, country (ISO kodu), currency, language ve payment_terms_days ekleyin. PATCH yalnızca gönderdiğiniz alanları değiştirir (null birini temizler) ve "archived": true arşivler. Belgeleri olan bir müşteri silinemez — bunun yerine arşivleyin, geçmişi bütün kalsın.

curl -X POST https://convertavo.com/tr/api/v1/clients \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Northwind Studio","email":"accounts@northwind.example","country":"US","currency":"USD"}'
GET/api/v1/invoices/{id}/pdf-a3

PDF/A-3 & XML

Faturalar ve iade faturaları için: aynı belge, Avrupa e-fatura standardı EN 16931 ile uyumlu yapılandırılmış veri olarak. /xml/ubl UBL 2.1, /xml/cii UN/CEFACT CII'dir; /pdf-a3 ise içinde CII dosyası factur-x.xml olarak bulunan PDF'nin PDF/A-3 kopyasıdır — insanların okuduğu, muhasebe yazılımlarının içe aktardığı tek bir dosya.

Uyumlu, ama ülkenizin kurallarına göre kontrol edilmemiş. E-fatura zorunlulukları ülkeden ülkeye farklılık gösterir ve sık değişir; bu dosyalar Avrupa standardının yapısını izler ve buradaki hiçbir şey onları belirli bir ülkenin (örneğin Türkiye'nin e-Fatura sisteminin) gereksinimlerine göre doğrulamaz. Satıcının ve alıcının ülkeleri gereklidir (düzenlemeden önce bunları işletme ve müşteri üzerinde ayarlayın); stopajlı bir fatura 409 yanıtı verir, çünkü bu biçimlerde onun için yer yoktur.
curl -X GET https://convertavo.com/tr/api/v1/invoices/0199a2b4-7a10-71d4-8c3b-1a2b3c4d5e6f/xml/ubl \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -o invoice-ubl.xml

Webhook'lar

Panelde (İşletme sekmesi → Webhook'lar) bir https adresi ekleyin ve olayları seçin. Her biri bir JSON POST'udur — olayın type değeri, bir created zamanı ve data.object olarak fatura (ödeme olaylarında ayrıca data.payment):

invoice.issued, invoice.sent, invoice.viewed, invoice.reminder_sent, invoice.overdue, invoice.paid, invoice.cancelled, invoice.credited, payment.recorded, payment.refunded, quote.accepted, quote.declined

  • İmzayı doğrulayın. Convertavo-Signature, t=<unix time>,v1=<signature> biçimindedir; burada imza, uç noktanızın imzalama gizli anahtarıyla <t>.<raw body> değerinin onaltılık HMAC-SHA256'sıdır. Yeniden hesaplayın, sabit sürede karşılaştırın ve beş dakikadan eski her şeyi reddedin.
  • Hızlı yanıt verin. 10 saniye içinde herhangi bir 2xx bir teslimattır. Başka her şey bir dakika, beş dakika, yarım saat, iki saat ve altı saat sonra yeniden denenir. Art arda 15 teslimatı başarısız olan bir adres, siz yeniden açana kadar kapatılır.
  • Tekrarları bekleyin. Convertavo-Delivery, bir teslimatın her yeniden denemesinde aynıdır: işlediklerinizi saklayın ve atlayın.
<?php
// $secret: the webhook's signing secret.
$body = file_get_contents('php://input');
$header = $_SERVER['HTTP_CONVERTAVO_SIGNATURE'] ?? '';

if (! preg_match('/^t=(\d+),v1=([0-9a-f]{64})$/', $header, $m)
    || abs(time() - (int) $m[1]) > 300
    || ! hash_equals(hash_hmac('sha256', $m[1].'.'.$body, $secret), $m[2])) {
    http_response_code(400);
    exit;
}

$event = json_decode($body, true);
// $event['type'], $event['data']['object'] …
http_response_code(200);
import { createHmac, timingSafeEqual } from 'node:crypto';

// rawBody: the request body exactly as received (a Buffer).
export function verify(rawBody, header, secret) {
  const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(header ?? '');
  if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
  const expected = createHmac('sha256', secret)
    .update(`${m[1]}.${rawBody}`)
    .digest();
  return timingSafeEqual(expected, Buffer.from(m[2], 'hex'));
}

Araç başvurusu

Her araç, kabul ettiği dosyalar, tüm ayarları ve çalışan bir istek. Genişletmek için bir araca tıklayın.

PDF 10 araç

PDF Sıkıştır compress-pdf PDF

Convertavo'nun PDF Sıkıştır aracı, büyük bir PDF'yi e-postaya ya da yükleme sınırına sığacak şekilde küçültür. Metniniz net kalır. Bir form 1 MB'tan küçük bir dosya istiyorsa bunu hedef boyut olarak yazabilirsiniz. İndirmeden önce yeni sayfanızı eskisiyle yan yana karşılaştırabilirsiniz.

POST /api/v1/tools/compress-pdf/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
5–15 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Compression level] isteğe bağlı string
Balanced (recommended)Maximum compressionLight — best quality
settings[Image quality] isteğe bağlı string
Web (150 DPI)Print (300 DPI)Keep original
settings[Target size (MB)] isteğe bağlı number Number. Örnek: 1080
switches[0] isteğe bağlı boolean Downsample embedded images. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Remove metadata and leftover editing data. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Subset embedded fonts. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/compress-pdf/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Compression level]=Balanced (recommended)' \
  -F 'settings[Image quality]=Web (150 DPI)' \
  -F 'settings[Target size (MB)]=1080' \
  -F "switches[0]=1"
JPG'yi PDF'ye Dönüştür jpg-to-pdf JPG, PNG, HEIC Birden fazla dosya

Fotoğrafları ya da taramaları sayfa boyutu, yön ve kenar boşlukları üzerinde kontrol sahibi olarak tek bir PDF'de birleştirin. 25 MB altı dosyalar için ücretsiz, hesap gerekmez.

POST /api/v1/tools/jpg-to-pdf/convert
Kabul ettiği
JPG, PNG, HEIC
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
3–8 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (JPG, PNG, HEIC). Boyut sınırı planınıza bağlıdır.
settings[Page size] isteğe bağlı string
A4LetterFit to image
settings[Orientation] isteğe bağlı string
AutoPortraitLandscape
settings[Margin] isteğe bağlı string
NoneSmallMedium
settings[Images per page] isteğe bağlı string
124
switches[0] isteğe bağlı boolean Compress images to reduce file size. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Add a page number to each page. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Sort files by name before combining. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/jpg-to-pdf/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F "files[]=@photo-2.jpg" \
  -F 'settings[Page size]=A4' \
  -F 'settings[Orientation]=Auto' \
  -F 'settings[Margin]=None' \
  -F "switches[0]=1"
PDF Birleştir merge-pdf PDF Birden fazla dosya

PDF'lerinizi yükleyin, sıralayın ve birleşik dosyayı indirin. Ücretsiz, hesap ve filigran olmadan.

POST /api/v1/tools/merge-pdf/convert
Kabul ettiği
PDF
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
2–5 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[File order] isteğe bağlı string
Manual (drag to reorder)Filename A–ZUpload order
switches[0] isteğe bağlı boolean Add a bookmark for each source file. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/merge-pdf/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F "files[]=@appendix.pdf" \
  -F 'settings[File order]=Manual (drag to reorder)' \
  -F "switches[0]=1"
PDF'yi Excel'e Dönüştür pdf-to-excel PDF

Convertavo'nun ücretsiz PDF'den Excel'e dönüştürücüsü PDF'nizdeki tabloları çıkarır ve gerçek bir tabloya yerleştirir. Satırlar ve sütunlar ait oldukları yerde kalır. Tabloda çizgi olmasa bile banka ekstrelerinde, faturalarda, fiyat listelerinde ve raporlarda çalışır.

POST /api/v1/tools/pdf-to-excel/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
10–30 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Page range] isteğe bağlı string Text. Örnek: 1-3
settings[Output format] isteğe bağlı string
Excel (.xlsx)CSV (.csv)Google Sheets
settings[Header row] isteğe bağlı string
Detect automaticallyFirst row is headerNo header
settings[Decimal separator] isteğe bağlı string
Point (1.50)Comma (1,50)
switches[0] isteğe bağlı boolean Keep empty rows. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Treat numbers as text. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/pdf-to-excel/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Page range]=1-3' \
  -F 'settings[Output format]=Excel (.xlsx)' \
  -F 'settings[Header row]=Detect automatically' \
  -F "switches[0]=1"
PDF'yi JPG'ye Dönüştür pdf-to-jpg PDF

Her sayfayı paylaşabileceğiniz, sitenize ekleyebileceğiniz ya da herhangi bir resim düzenleyicide düzenleyebileceğiniz bir JPG, PNG veya WebP'ye çevirin. Ücretsiz, hesap ve filigran olmadan.

POST /api/v1/tools/pdf-to-jpg/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
4–12 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Page range] isteğe bağlı string Text. Örnek: 1-3
settings[Image format] isteğe bağlı string
JPGPNGWebP
settings[Resolution] isteğe bağlı string
150 DPI (screen)300 DPI (print)600 DPI (archival)
settings[Quality] isteğe bağlı integer Whole number, 1–100. Örnek: 80
switches[0] isteğe bağlı boolean Deliver as a zip archive. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Use a white background instead of transparency. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Extract embedded images only. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/pdf-to-jpg/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Page range]=1-3' \
  -F 'settings[Image format]=JPG' \
  -F 'settings[Resolution]=150 DPI (screen)' \
  -F "switches[0]=1"
PDF'yi Metne Dönüştür pdf-to-text PDF

Bir PDF yükleyin, saniyeler içinde temiz ve kopyalanabilir metin alın. Taranmış sayfalar otomatik olarak OCR'dan geçer. Ücretsiz, hesap ve filigran olmadan.

POST /api/v1/tools/pdf-to-text/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
3–8 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Page range] isteğe bağlı string Text. Örnek: 1-3
settings[Output format] isteğe bağlı string
Plain text (.txt)Word (.docx)Markdown (.md)Web page (.html)JSON (pages, lines, tables)
settings[Text layout] isteğe bağlı string
Keep line breaksMerge into paragraphsPreserve layout (columns & spacing)Single block of text
settings[Language] isteğe bağlı string
Auto-detectEnglishUrduArabicHindiChinese (Simplified)Chinese (Traditional)SpanishFrenchGermanPortugueseRussianJapaneseKoreanItalianTurkishPersian (Farsi)BengaliPunjabiPashtoSindhiNepaliMarathiGujaratiTamilTeluguIndonesianMalayVietnameseThaiFilipinoDutchPolishUkrainianSwedishCzechRomanianHungarianGreekHebrew
settings[Document password] isteğe bağlı string Text. Örnek: your-pdf-password
settings[Translate to (optional, machine translation)] isteğe bağlı string
Don't translateEnglishUrduArabicSpanishFrenchGermanHindiChineseRussianPortugueseTurkishItalian
switches[0] isteğe bağlı boolean Run OCR when no text layer is found. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Keep tables as tab-separated columns. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Remove headers and page numbers. Açmak için 1 gönderin.
switches[3] isteğe bağlı boolean Mark where each page starts. Açmak için 1 gönderin.
switches[4] isteğe bağlı boolean Fix words split across lines. Açmak için 1 gönderin.
switches[5] isteğe bağlı boolean Re-read every page with OCR (fixes garbled text). Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/pdf-to-text/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Page range]=1-3' \
  -F 'settings[Output format]=Plain text (.txt)' \
  -F 'settings[Text layout]=Keep line breaks' \
  -F "switches[0]=1"
PDF'yi Word'e Dönüştür pdf-to-word PDF

Convertavo'nun ücretsiz PDF'den Word'e dönüştürücüsü PDF'nizi gerçek bir Word dosyasına çevirir. Her sayfanın tamamen aynı görünmesini sağlayın ya da kelimeleri düzenleyebileceğiniz paragraflar olarak alın. Taranmış PDF'ler de çalışır: sayfaları dönüştürmenin bir parçası olarak OCR ile okunur.

POST /api/v1/tools/pdf-to-word/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
8–20 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Page range] isteğe bağlı string Text. Örnek: 1-3
settings[Output] isteğe bağlı string
Word (.docx)OpenDocument (.odt)Rich text (.rtf)
settings[Layout mode] isteğe bağlı string
Same layout, editableKeep exact layoutFlowing textText only
settings[Picture quality] isteğe bağlı string
High (200 DPI)Very high (300 DPI)Smaller file (150 DPI)
settings[Language] isteğe bağlı string
Auto-detectEnglishUrduArabicHindiChinese (Simplified)Chinese (Traditional)SpanishFrenchGermanPortugueseRussianJapaneseKoreanItalianTurkishPersian (Farsi)BengaliPunjabiPashtoSindhiNepaliMarathiGujaratiTamilTeluguIndonesianMalayVietnameseThaiFilipinoDutchPolishUkrainianSwedishCzechRomanianHungarianGreekHebrew
settings[Document password] isteğe bağlı string Text. Örnek: your-pdf-password
settings[Translate to (optional, machine translation)] isteğe bağlı string
Don't translateEnglishUrduArabicSpanishFrenchGermanHindiChineseRussianPortugueseTurkishItalian
switches[0] isteğe bağlı boolean Run OCR on scanned pages. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Keep images and graphics. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Convert tables to Word tables. Açmak için 1 gönderin.
switches[3] isteğe bağlı boolean Keep fonts, sizes and colours. Açmak için 1 gönderin.
switches[4] isteğe bağlı boolean Leave out repeated headers, footers and page numbers. Açmak için 1 gönderin.
switches[5] isteğe bağlı boolean Start each PDF page on a new Word page. Açmak için 1 gönderin.
switches[6] isteğe bağlı boolean Add a table of contents from the headings. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/pdf-to-word/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Page range]=1-3' \
  -F 'settings[Output]=Word (.docx)' \
  -F 'settings[Layout mode]=Same layout, editable' \
  -F "switches[0]=1"
PDF Döndür rotate-pdf PDF

Convertavo'nun ücretsiz aracı PDF sayfalarını online döndürmenize ve değişikliği kalıcı olarak kaydetmenize olanak tanır. Dosyanın tamamını, tek bir sayfayı ya da yalnızca yanlış çıkan sayfaları çevirin. Yan ve ters duran sayfaları kendi başına bile bulabilir.

POST /api/v1/tools/rotate-pdf/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
2–4 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Rotation] isteğe bağlı string
90° clockwise90° counter-clockwise180°
settings[Apply to] isteğe bağlı string
All pagesOdd pages onlyEven pages onlySelected pages
settings[Selected pages] isteğe bağlı string Text. Örnek: 3, 7
switches[0] isteğe bağlı boolean Detect page orientation automatically. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Keep the original file as a copy. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/rotate-pdf/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Rotation]=90° clockwise' \
  -F 'settings[Apply to]=All pages' \
  -F 'settings[Selected pages]=3, 7' \
  -F "switches[0]=1"
PDF Böl split-pdf PDF

Convertavo'nun ücretsiz aracı bir PDF'yi online olarak ayrı dosyalara böler. Tek bir sayfayı alın, 3 ile 7. sayfaları çıkarın ya da istediğiniz sayfa aralıklarını yazarak uzun bir raporu parçalara ayırın. Bunu tarayıcınızda yaşayan bir PDF kesici olarak düşünün. Hiçbir şey kurmanız gerekmez.

POST /api/v1/tools/split-pdf/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
2–6 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Pages to extract] isteğe bağlı string Text. Örnek: 1-5, 12
settings[Filename prefix] isteğe bağlı string Text. Örnek: part

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/split-pdf/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Pages to extract]=1-5, 12' \
  -F 'settings[Filename prefix]=part'
PDF Şifresini Kaldır unlock-pdf PDF

Convertavo'nun ücretsiz aracı bir PDF'nin şifresini kaldırır; böylece dosya her seferinde sormadan açılır. Birçok banka ekstreleri doğum tarihinizle kilitler ve bunu her ay yazmak çabuk bıktırır. Burada bir kez girin. İndirdiğiniz şey, diğer dosyalar gibi açabileceğiniz, basabileceğiniz, birleştirebileceğiniz ya da dönüştürebileceğiniz sade bir PDF'dir.

POST /api/v1/tools/unlock-pdf/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
2–5 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Document password] isteğe bağlı string Text. Örnek: your-pdf-password
settings[Remove] isteğe bağlı string
BothOpen passwordPermissions only
switches[0] isteğe bağlı boolean Allow printing after unlocking. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Allow copying text after unlocking. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Allow editing after unlocking. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/unlock-pdf/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Document password]=your-pdf-password' \
  -F 'settings[Remove]=Both' \
  -F "switches[0]=1"

Resim 7 araç

Görsel Sıkıştır compress-image JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF Birden fazla dosya

Convertavo'nun ücretsiz resim sıkıştırıcısı fotoğrafları bulanıklaştırmadan küçültür. Çoğu resim %60 ile %80 daha hafif çıkar ve bir fark görmezsiniz. 25 MB'a kadar JPG, PNG ya da WebP dosyaları ekleyin, bir kalite seçin ve indirin.

POST /api/v1/tools/compress-image/convert
Kabul ettiği
JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
4–10 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF). Boyut sınırı planınıza bağlıdır.
settings[Compression] isteğe bağlı string
Smart — no visible differenceMaximum — smallest fileLossless — pixel-perfectCustom qualityTarget file size
settings[Quality] isteğe bağlı integer Whole number, 1–100. Örnek: 80
settings[Target size (KB)] isteğe bağlı number Number. Örnek: 200
settings[Output format] isteğe bağlı string
Keep originalSmallest (auto)JPGPNGWebPAVIF
settings[Resize] isteğe bağlı string
Keep original sizeMax 3840 px (4K)Max 2560 pxMax 1920 px (Full HD)Max 1280 pxMax 1080 pxMax 800 pxScale to 75%Scale to 50%Scale to 25%Custom width and height
settings[Max width (px)] isteğe bağlı number Number. Örnek: 1920
settings[Max height (px)] isteğe bağlı number Number. Örnek: 1080
settings[Background for transparency] isteğe bağlı string
WhiteBlack
settings[File names] isteğe bağlı string
Keep original namesAdd "-compressed"Add "-min"
switches[0] isteğe bağlı boolean Strip EXIF and location data. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Convert PNG photos to JPG when smaller. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Keep the colour profile. Açmak için 1 gönderin.
switches[3] isteğe bağlı boolean Keep animation (GIF and WebP). Açmak için 1 gönderin.
switches[4] isteğe bağlı boolean Never make a file bigger. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/compress-image/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F "files[]=@photo-2.jpg" \
  -F 'settings[Compression]=Smart — no visible difference' \
  -F 'settings[Quality]=80' \
  -F 'settings[Target size (KB)]=200' \
  -F "switches[0]=1"
Görseli Kırp crop-image JPG, PNG, WebP Birden fazla dosya

Instagram için kare ya da hikâye için dikey bir fotoğraf mı lazım? Convertavo'nun ücretsiz kırpma aracı, tutmak istediğiniz kısmın üzerine doğrudan tarayıcınızda bir kutu çizmenize olanak tanır. Çoğu kırpma 2 ile 5 saniyede biter.

POST /api/v1/tools/crop-image/convert
Kabul ettiği
JPG, PNG, WebP
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
2–5 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (JPG, PNG, WebP). Boyut sınırı planınıza bağlıdır.
settings[Aspect ratio] isteğe bağlı string
Free1:1 square16:94:33:29:16 story
settings[Width (px)] isteğe bağlı number Number. Örnek: 1080
settings[Height (px)] isteğe bağlı number Number. Örnek: 1080
settings[Anchor] isteğe bağlı string
CentreTopBottomLeftRight
switches[0] isteğe bağlı boolean Apply the same crop to every image. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/crop-image/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F "files[]=@photo-2.jpg" \
  -F 'settings[Aspect ratio]=Free' \
  -F 'settings[Width (px)]=1080' \
  -F 'settings[Height (px)]=1080' \
  -F "switches[0]=1"
HEIC'ten JPG'ye heic-to-jpg HEIC, HEIF Birden fazla dosya

Biri size iPhone'undan bir fotoğraf gönderdi ve Windows bilgisayarınız açmıyor mu? Convertavo'nun ücretsiz HEIC'ten JPG'ye dönüştürücüsü onu her telefonun, bilgisayarın ve web sitesinin açabildiği normal bir JPG'ye çevirir. Tek bir fotoğraf ya da bütün bir klasör bırakın. Genellikle 3 ile 7 saniye sürer.

POST /api/v1/tools/heic-to-jpg/convert
Kabul ettiği
HEIC, HEIF
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
3–7 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (HEIC, HEIF). Boyut sınırı planınıza bağlıdır.
settings[JPG quality] isteğe bağlı integer Whole number, 1–100. Örnek: 80
settings[Output format] isteğe bağlı string
JPGPNGWebP
settings[Max dimension] isteğe bağlı number Number. Örnek: 2048
switches[0] isteğe bağlı boolean Keep EXIF data such as date and camera. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Keep GPS location data. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/heic-to-jpg/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@IMG_0412.heic" \
  -F "files[]=@IMG_0413.heic" \
  -F 'settings[JPG quality]=80' \
  -F 'settings[Output format]=JPG' \
  -F 'settings[Max dimension]=2048' \
  -F "switches[0]=1"
PNG'yi JPG'ye Dönüştür png-to-jpg PNG Birden fazla dosya

Telefonunuz her ekran görüntüsünü PNG olarak kaydeder ve bu dosyalar hızla birikir. Convertavo'nun ücretsiz PNG'den JPG'ye dönüştürücüsü onları aynı görünen çok daha küçük JPG'lere çevirir. Örneğimizde 596 KB'lık bir ekran görüntüsü 162 KB çıktı. Tek bir dosya ya da bütün bir klasör ekleyin; genellikle 2 ile 6 saniye sürer.

POST /api/v1/tools/png-to-jpg/convert
Kabul ettiği
PNG
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
2–6 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (PNG). Boyut sınırı planınıza bağlıdır.
settings[JPG quality] isteğe bağlı integer Whole number, 1–100. Örnek: 80
settings[Background for transparency] isteğe bağlı string
WhiteBlackCustom colour
settings[Custom colour] isteğe bağlı string Text. Örnek: #F5E6CC
settings[Max width] isteğe bağlı number Number. Örnek: 1920
switches[0] isteğe bağlı boolean Strip metadata. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Optimise for the web. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Keep the colour profile. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/png-to-jpg/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@image.png" \
  -F "files[]=@image-2.png" \
  -F 'settings[JPG quality]=80' \
  -F 'settings[Background for transparency]=White' \
  -F 'settings[Custom colour]=#F5E6CC' \
  -F "switches[0]=1"
Arka Planı Kaldır remove-background JPG, PNG, WebP

Arkasındaki dağınık oda olmadan yalnızca kişiyi ya da ürünü mü istiyorsunuz? Convertavo'nun ücretsiz arka plan kaldırıcısı konuyu keser ve size temiz, saydam bir PNG verir. Fırça yok, elle çizim yok. Genellikle 8 ile 20 saniye sürer.

POST /api/v1/tools/remove-background/convert
Kabul ettiği
JPG, PNG, WebP
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
8–20 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (JPG, PNG, WebP). Boyut sınırı planınıza bağlıdır.
settings[Output] isteğe bağlı string
Transparent PNGWhite backgroundCustom colour
settings[Custom colour] isteğe bağlı string Text. Örnek: #F5E6CC
settings[Edge refinement] isteğe bağlı string
StandardSoft (hair and fur)Sharp (products)
switches[0] isteğe bağlı boolean Keep the original resolution. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Add a soft shadow under the subject. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Crop tightly to the subject. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/remove-background/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F 'settings[Output]=Transparent PNG' \
  -F 'settings[Custom colour]=#F5E6CC' \
  -F 'settings[Edge refinement]=Standard' \
  -F "switches[0]=1"
Görseli Yeniden Boyutlandır resize-image JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF Birden fazla dosya

Tam bir genişlik ve yükseklik belirleyin ya da yüzdeyle ölçekleyin. Bir baskı boyutunu ya da KB sınırını da hedefleyebilirsiniz. En-boy oranı varsayılan olarak kilitlidir.

POST /api/v1/tools/resize-image/convert
Kabul ettiği
JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
3–8 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF). Boyut sınırı planınıza bağlıdır.
settings[Resize by] isteğe bağlı string
Exact size (width × height)Popular size (preset)PercentageLongest sidePrint size (cm, mm or inches)File size (KB)
settings[Preset size] isteğe bağlı string
Instagram · Square post — 1080 × 1080Instagram · Portrait post — 1080 × 1350Instagram · Landscape post — 1080 × 566Instagram · Story or Reel — 1080 × 1920Facebook · Post — 1200 × 630Facebook · Cover photo — 851 × 315Facebook · Profile picture — 320 × 320X (Twitter) · Post — 1600 × 900X (Twitter) · Header — 1500 × 500LinkedIn · Post — 1200 × 627LinkedIn · Banner — 1584 × 396YouTube · Thumbnail — 1280 × 720YouTube · Channel banner — 2560 × 1440TikTok · Video cover — 1080 × 1920Pinterest · Pin — 1000 × 1500WhatsApp · Profile photo — 500 × 500WhatsApp · Status — 1080 × 1920Passport photo · 2 × 2 in (US) — 600 × 600Passport photo · 35 × 45 mm — 413 × 531Website · Blog image — 1200 × 800Email header — 600 × 200App icon or favicon — 512 × 512HD — 1280 × 720Full HD — 1920 × 10804K UHD — 3840 × 2160A4 page at 300 DPI — 2480 × 3508
settings[Width (px)] isteğe bağlı number Number. Örnek: 1920
settings[Height (px)] isteğe bağlı number Number. Örnek: 1080
settings[Percentage (%)] isteğe bağlı number Number. Örnek: 50
settings[Longest side (px)] isteğe bağlı number Number. Örnek: 1920
settings[Print width] isteğe bağlı number Number. Örnek: 10
settings[Print height] isteğe bağlı number Number. Örnek: 15
settings[Unit] isteğe bağlı string
cmmminches
settings[Target file size (KB)] isteğe bağlı number Number. Örnek: 200
settings[Resize mode] isteğe bağlı string
Fit insideFill and cropPad to exact sizeStretch
settings[Crop focus] isteğe bağlı string
Smart — find the subjectCentreTopBottomLeftRight
settings[Padding] isteğe bağlı string
WhiteBlackTransparentBlurred pictureAverage colour
settings[Output format] isteğe bağlı string
Keep originalJPGPNGWebPAVIF
settings[Quality] isteğe bağlı integer Whole number, 1–100. Örnek: 80
settings[Resampling] isteğe bağlı string
Lanczos — sharpest, for photosBicubic — smoothBilinear — softestNearest — pixel art and icons
settings[Print resolution (DPI)] isteğe bağlı string
Keep original7296150300600
settings[File names] isteğe bağlı string
Keep original namesAdd "-resized"Add the new size (e.g. -1080x1080)
switches[0] isteğe bağlı boolean Lock aspect ratio. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Do not enlarge images that are already smaller. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Sharpen after resizing. Açmak için 1 gönderin.
switches[3] isteğe bağlı boolean Strip EXIF and location data. Açmak için 1 gönderin.
switches[4] isteğe bağlı boolean Keep animation (GIF and WebP). Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/resize-image/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F "files[]=@photo-2.jpg" \
  -F 'settings[Resize by]=Exact size (width × height)' \
  -F 'settings[Preset size]=Instagram · Square post — 1080 × 1080' \
  -F 'settings[Width (px)]=1920' \
  -F "switches[0]=1"
WebP Dönüştürücü webp-converter JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF Birden fazla dosya

Bir web sitesinden bir resim kaydettiniz ve .webp dosyası olarak mı çıktı? Convertavo'nun ücretsiz WebP dönüştürücüsü onu her yerde açılan bir JPG ya da PNG'ye çevirir. Diğer yönde de çalışır; JPG ve PNG dosyalarını 2 ile 5 saniyede web siteniz için küçük WebP resimlerine dönüştürür.

POST /api/v1/tools/webp-converter/convert
Kabul ettiği
JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
2–5 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF). Boyut sınırı planınıza bağlıdır.
settings[Convert to] isteğe bağlı string
WebPJPGPNGAVIFGIF (keeps animation)ICO (favicon)TIFFBMP
settings[Compression] isteğe bağlı string
Smart — no visible differenceMaximum — smallest fileLossless — pixel-perfectCustom qualityTarget file size
settings[Quality] isteğe bağlı integer Whole number, 1–100. Örnek: 80
settings[Target size (KB)] isteğe bağlı number Number. Örnek: 200
settings[Resize] isteğe bağlı string
Keep original sizeMax 3840 px (4K)Max 2560 pxMax 1920 px (Full HD)Max 1280 pxMax 1080 pxMax 800 pxScale to 75%Scale to 50%Scale to 25%Custom width and height
settings[Max width (px)] isteğe bağlı number Number. Örnek: 1920
settings[Max height (px)] isteğe bağlı number Number. Örnek: 1080
settings[Background for transparency] isteğe bağlı string
WhiteBlack
settings[WebP effort] isteğe bağlı string
BalancedFastSmallest file (slower)
settings[File names] isteğe bağlı string
Keep original namesAdd "-compressed"Add "-min"
switches[0] isteğe bağlı boolean Keep EXIF data such as date and camera. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Lossless — no quality loss, larger file. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Keep the colour profile. Açmak için 1 gönderin.
switches[3] isteğe bağlı boolean Keep animation (GIF and WebP). Açmak için 1 gönderin.
switches[4] isteğe bağlı boolean Keep exact colours under transparency. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/webp-converter/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F "files[]=@photo-2.jpg" \
  -F 'settings[Convert to]=WebP' \
  -F 'settings[Compression]=Smart — no visible difference' \
  -F 'settings[Quality]=80' \
  -F "switches[0]=1"

OCR 3 araç

Resmi Excel'e Dönüştür image-to-excel JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF

Üzerinde tablo olan bir fotoğraf, ekran görüntüsü ya da taranmış sayfa yükleyin; her değerin kendi hücresinde olduğu gerçek bir tablo alın. Ücretsiz, 25 MB'a kadar dosyalar için hesap gerekmez.

POST /api/v1/tools/image-to-excel/convert
Kabul ettiği
JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
3–10 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (JPG, PNG, WebP, HEIC, AVIF, GIF, BMP, TIFF). Boyut sınırı planınıza bağlıdır.
settings[Language] isteğe bağlı string
Auto-detectEnglishUrduArabicChinese
settings[Output format] isteğe bağlı string
Excel (.xlsx)CSV (.csv)
settings[Header row] isteğe bağlı string
Detect automaticallyFirst row is headerNo header
settings[Decimal separator] isteğe bağlı string
Point (1.50)Comma (1,50)
switches[0] isteğe bağlı boolean Merge cells that span multiple columns. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Keep empty rows. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Treat numbers as text. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/image-to-excel/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F 'settings[Language]=Auto-detect' \
  -F 'settings[Output format]=Excel (.xlsx)' \
  -F 'settings[Header row]=Detect automatically' \
  -F "switches[0]=1"
Görselden Metne image-to-text JPG, PNG, HEIC, WebP, TIFF, BMP, GIF Birden fazla dosya

Bir fotoğraf, ekran görüntüsü ya da tarama yükleyin; kopyalayabileceğiniz, düzenleyebileceğiniz ve arayabileceğiniz seçilebilir metin alın. Ücretsiz, 25 MB'a kadar dosyalar için hesap gerekmez.

POST /api/v1/tools/image-to-text/convert
Kabul ettiği
JPG, PNG, HEIC, WebP, TIFF, BMP, GIF
İstek başına dosya
Planınızın grup boyutuna kadar (Free'de 5, Business'ta 100'e kadar)
Tipik süre
5–15 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file[] Bir ya da daha fazla dosya (JPG, PNG, HEIC, WebP, TIFF, BMP, GIF). Boyut sınırı planınıza bağlıdır.
settings[Language] isteğe bağlı string
Auto-detectEnglishUrduArabicHindiChinese (Simplified)Chinese (Traditional)SpanishFrenchGermanPortugueseRussianJapaneseKoreanItalianTurkishPersian (Farsi)BengaliPunjabiPashtoSindhiNepaliMarathiGujaratiTamilTeluguIndonesianMalayVietnameseThaiFilipinoDutchPolishUkrainianSwedishCzechRomanianHungarianGreekHebrew
settings[Second language (mixed text)] isteğe bağlı string
NoneEnglishUrduArabicHindiChinese (Simplified)Chinese (Traditional)SpanishFrenchGermanPortugueseRussianJapaneseKoreanItalianTurkishPersian (Farsi)BengaliPunjabiPashtoSindhiNepaliMarathiGujaratiTamilTeluguIndonesianMalayVietnameseThaiFilipinoDutchPolishUkrainianSwedishCzechRomanianHungarianGreekHebrew
settings[Image mode] isteğe bağlı string
AutoPrinted documentScreenshotPhoto of a pageHandwritingSign or sparse textSingle lineMath formula (LaTeX)
settings[Layout] isteğe bağlı string
Keep line breaksMerge into paragraphsPreserve layout (columns & spacing)Single block of text
settings[Output format] isteğe bağlı string
Plain text (.txt)Word (.docx)Searchable PDFMarkdown (.md)JSON (words, positions, confidence)
settings[Translate to (optional, machine translation)] isteğe bağlı string
Don't translateEnglishUrduArabicSpanishFrenchGermanHindiChineseRussianPortugueseTurkishItalian
switches[0] isteğe bağlı boolean Enhance contrast before reading. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Correct page skew automatically. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Flag low-confidence words. Açmak için 1 gönderin.
switches[3] isteğe bağlı boolean Clean up stray symbols and noise. Açmak için 1 gönderin.
switches[4] isteğe bağlı boolean Combine a batch into one file. Açmak için 1 gönderin.
switches[5] isteğe bağlı boolean Detect QR codes and barcodes. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/image-to-text/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg" \
  -F "files[]=@photo-2.jpg" \
  -F 'settings[Language]=Auto-detect' \
  -F 'settings[Second language (mixed text)]=None' \
  -F 'settings[Image mode]=Auto' \
  -F "switches[0]=1"
PDF OCR pdf-ocr PDF

Convertavo'nun PDF OCR aracı taranmış bir PDF'yi aranabilir bir PDF'ye dönüştürür. Dosyanızı yükleyin, dili seçin ve içinde arama yapabileceğiniz, metin seçip kopyalayabileceğiniz bir kopya indirin.

POST /api/v1/tools/pdf-ocr/convert
Kabul ettiği
PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
10–40 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PDF). Boyut sınırı planınıza bağlıdır.
settings[Language] isteğe bağlı string
Auto-detectEnglishSpanishUrduArabicChinese
settings[Page range] isteğe bağlı string Text. Örnek: 1-3
settings[Output] isteğe bağlı string
Searchable PDF (same look)Searchable PDF + text file

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/pdf-ocr/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@document.pdf" \
  -F 'settings[Language]=Auto-detect' \
  -F 'settings[Page range]=1-3' \
  -F 'settings[Output]=Searchable PDF (same look)'

Medya 3 araç

Video Sıkıştır compress-video MP4, MOV, MKV, AVI

Video e-postayla gönderilemeyecek kadar büyük mü, ya da WhatsApp göndermiyor mu? Convertavo'nun ücretsiz video sıkıştırıcısı onu lapaya çevirmeden ihtiyacınız olan boyuta küçültür. Bir MP4, MOV, MKV ya da AVI yükleyin, istediğiniz boyutu yazın; çoğu video 1 ile 4 dakikada biter.

POST /api/v1/tools/compress-video/convert
Kabul ettiği
MP4, MOV, MKV, AVI
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
60–240 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (MP4, MOV, MKV, AVI). Boyut sınırı planınıza bağlıdır.
settings[Compression level] isteğe bağlı string
Balanced (recommended)MaximumLight — best quality
settings[Target size (MB)] isteğe bağlı number Number. Örnek: 25
settings[Resolution] isteğe bağlı string
Keep original1080p720p480p
settings[Codec] isteğe bağlı string
H.264H.265
switches[0] isteğe bağlı boolean Reduce the frame rate to 30 fps. Açmak için 1 gönderin.
switches[1] isteğe bağlı boolean Lower the audio bitrate to 128 kbps. Açmak için 1 gönderin.
switches[2] isteğe bağlı boolean Remove audio entirely. Açmak için 1 gönderin.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/compress-video/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@video.mp4" \
  -F 'settings[Compression level]=Balanced (recommended)' \
  -F 'settings[Target size (MB)]=25' \
  -F 'settings[Resolution]=Keep original' \
  -F "switches[0]=1"
MOV'u MP4'e Dönüştür mov-to-mp4 MOV, AVI, MKV, WebM

iPhone videonuz telefonda sorunsuz oynuyor, sonra bir Windows bilgisayarda açılmıyor. Convertavo'nun ücretsiz MOV'dan MP4'e dönüştürücüsü bunu tek adımda, kurulacak bir şey olmadan çözer. MOV'u yükleyin, varsayılan ayarları koruyun; çoğu video 30 ile 120 saniyede hazır olur.

POST /api/v1/tools/mov-to-mp4/convert
Kabul ettiği
MOV, AVI, MKV, WebM
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
30–120 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (MOV, AVI, MKV, WebM). Boyut sınırı planınıza bağlıdır.
settings[Quality] isteğe bağlı string
Same as source1080p720p480p
settings[Video codec] isteğe bağlı string
H.264 (most compatible)H.265 (smaller files)

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/mov-to-mp4/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@video.mp4" \
  -F 'settings[Quality]=Same as source' \
  -F 'settings[Video codec]=H.264 (most compatible)'
MP4'ü MP3'e Dönüştür mp4-to-mp3 MP4, MOV, MKV, AVI

Bir videodan yalnızca sesi mi istiyorsunuz; otobüs için bir ders ya da bir konser klibinden bir şarkı gibi? Convertavo'nun ücretsiz MP4'ten MP3'e dönüştürücüsü sesi tutar ve görüntüyü atar. Videoyu yükleyin, kaliteyi seçin ve MP3'ünüzü genellikle bir dakikadan kısa sürede indirin.

POST /api/v1/tools/mp4-to-mp3/convert
Kabul ettiği
MP4, MOV, MKV, AVI
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
20–60 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (MP4, MOV, MKV, AVI). Boyut sınırı planınıza bağlıdır.
settings[Bitrate] isteğe bağlı string
192 kbps (recommended)320 kbps128 kbps
settings[Channels] isteğe bağlı string
StereoMono

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/mp4-to-mp3/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@video.mp4" \
  -F 'settings[Bitrate]=192 kbps (recommended)' \
  -F 'settings[Channels]=Stereo'

Yapay zekâ 2 araç

Yapay Zeka Sanat Dedektörü ai-art-detector JPG, PNG, WebP

İnternette bir çizim buldunuz ve bir şey size tuhaf mı geliyor? Convertavo'nun ücretsiz yapay zekâ sanat dedektörü bir çizimin, tablonun ya da illüstrasyonun bir yapay zekâ resim üreticisinden çıkıp çıkmadığını kontrol eder. Yalnızca bir puan almazsınız, kanıtları görürsünüz. Bir JPG, PNG ya da WebP yükleyin; yanıt genellikle 2 ile 4 saniye sürer.

POST /api/v1/tools/ai-art-detector/convert
Kabul ettiği
JPG, PNG, WebP
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
2–4 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (JPG, PNG, WebP). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/ai-art-detector/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg"
Yapay Zeka Görsel Dedektörü ai-image-detector JPG, PNG, WebP

Bir görsel yükleyin; Convertavo'nun yapay zeka görsel dedektörü onun üretilip üretilmediğini tahmin eder. Bu bir tahmindir, kanıt değil. Bir karar, modelin ne kadar emin olduğu ve arkasındaki kanıtları alırsınız. Dürüst yanıt «söylenemez» olduğunda rapor bunu açıkça belirtir.

POST /api/v1/tools/ai-image-detector/convert
Kabul ettiği
JPG, PNG, WebP
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
2–4 saniye

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (JPG, PNG, WebP). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/ai-image-detector/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@photo.jpg"

Linkler 5 araç

Toplu Link Kısaltıcı bulk-url-shortener

Bütün bir link listesini mi kısaltmanız gerekiyor? Onları her satıra bir tane olacak şekilde Convertavo'nun toplu link kısaltıcısına yapıştırın ya da bir CSV dosyası yükleyin. Her kısa link, her biri kendi QR koduyla tek bir tabloda geri gelir. Ücretsizdir ve tek seferde 50 linke kadar hesaba bile ihtiyacınız yoktur.

POST /api/v1/tools/bulk-url-shortener/convert
Kabul ettiği
Her dosya
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
bir iki dakika

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (her tür). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/bulk-url-shortener/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@file.bin"
Kısa Link Açıcı expand-url

Birinin size gönderdiği bir kısa linkten emin değil misiniz? Convertavo'nun kısa link denetleyicisine bırakın; ona dokunmadan önce gerçek adresi görün. Linki sizin için izler ve tam adresi, yoldaki her durağı ve bir güvenlik kontrolünü gösteririz. Hesap yok, uygulama yok.

POST /api/v1/tools/expand-url/convert
Kabul ettiği
Her dosya
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
anında

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (her tür). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/expand-url/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@file.bin"
Link Kısaltıcı url-shortener

Linkiniz SMS'te bölünecek kadar uzun mu? Convertavo'nun ücretsiz link kısaltıcısına yapıştırın, yaklaşık bir saniyede kısa bir link alın. Her link bir QR kod ve tıklama sayacıyla gelir. Hesap gerekmez. Hiçbir özellik ücretli planın arkasında da değildir.

POST /api/v1/tools/url-shortener/convert
Kabul ettiği
Her dosya
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
anında

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (her tür). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/url-shortener/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@file.bin"
UTM Link Oluşturucu utm-builder

Did that newsletter actually bring anyone to your site, or was it the Instagram post? Run the link through Convertavo’s UTM builder before you share it, and your analytics will finally tell you. The tagged link comes out long and ugly (that’s normal), so shorten it right here. No account needed, and it costs nothing.

POST /api/v1/tools/utm-builder/convert
Kabul ettiği
Her dosya
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
anında

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (her tür). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/utm-builder/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@file.bin"

İşletme 1 araç

Fatura Oluşturucu invoice-generator

Müşterinizin dilinde ve para biriminde profesyonel bir fatura hazırlayın. Vergiler, indirimler ve stopaj tam olarak hesaplanır; filigransız bir PDF alırsınız — hesap gerekmez.

POST /api/v1/tools/invoice-generator/convert
Kabul ettiği
Her dosya
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
anında

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (her tür). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/invoice-generator/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@file.bin"

QR Kod 2 araç

QR Kod Oluşturucu qr-code-generator

Link, Wi-Fi ağı, kartvizit ya da WhatsApp sohbeti için QR kod oluşturun. Renkleri, nokta şeklini, çerçeveyi ve logoyu seçin, sonra indirin.

POST /api/v1/tools/qr-code-generator/convert
Kabul ettiği
Her dosya
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
anında

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (her tür). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/qr-code-generator/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@file.bin"
QR Kod Okuyucu qr-code-scanner PNG, JPG, WebP, GIF, PDF

Ücretsiz QR kod ve barkod okuyucu. Kameranızdan, bir fotoğraftan, ekran görüntüsünden ya da PDF'den okutun; her link siz açmadan önce kontrol edilir.

POST /api/v1/tools/qr-code-scanner/convert
Kabul ettiği
PNG, JPG, WebP, GIF, PDF
İstek başına dosya
Bir (istek başına tek dosya gönderin)
Tipik süre
anında

İstek gövdesi multipart/form-data

AlanTürAçıklama
files[] zorunlu file Dönüştürülecek dosya (PNG, JPG, WebP, GIF, PDF). Boyut sınırı planınıza bağlıdır.

Örnek istek

curl -X POST https://convertavo.com/tr/api/v1/tools/qr-code-scanner/convert \
  -H "Authorization: Bearer $CONVERTAVO_KEY" \
  -F "files[]=@image.png"