API

Genel Bakış

Convert2WebP API, görüntüleri program aracılığıyla formatlar arasında dönüştürmenize olanak tanır. Resminizle birlikte çok parçalı bir istek gönderin ve dönüştürülen dosyayı yanıt gövdesinde alın. Tüm işlemler, çoğu dosya için bir saniyeden kısa gecikme süresiyle sunucu tarafında gerçekleşir.

Kimlik doğrulama

Kimlik doğrulama gerekmez. API ücretsiz ve açıktır. Tüm isteklerin hızı, IP adresi başına dakikada 60 istekle sınırlıdır.

Hız sınırlama

Hız limitleri IP adresi başına uygulanır. Tüm yanıtlar hız sınırı başlıklarını içerir.

Hız sınırı başlıkları her yanıtta bulunur: X-RateLimit-Remaining, X-RateLimit-Reset.

Uç noktalar

curl -X POST https://convert2webp.com/api/v1/convert \
  -F "file=@photo.png" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.webp

curl -X POST https://convert2webp.com/api/v1/batch \
  -F "files=@image1.png" \
  -F "files=@image2.jpg" \
  -F "files=@image3.gif" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.zip

curl https://convert2webp.com/api/v1/formats

{
  "input": [
    "png", "jpg", "jpeg", "gif", "bmp",
    "tiff", "svg", "avif", "ico", "webp"
  ],
  "output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}

curl https://convert2webp.com/api/v1/health

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-04-04T12:00:00.000Z"
}

Hata kodları

Tüm hata yanıtları JSON gövdesini döndürür. error neyin yanlış gittiğini açıklayan nesne.

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}