API

Panoramica

Convert2WebP API consente di convertire le immagini tra formati in modo programmatico. Invia una richiesta in più parti con la tua immagine e ricevi il file convertito nel corpo della risposta. Tutta l'elaborazione avviene lato server con una latenza inferiore al secondo per la maggior parte dei file.

Autenticazione

Non è richiesta alcuna autenticazione. API è gratuito e aperto. Tutte le richieste hanno una velocità limitata a 60 richieste al minuto per indirizzo IP.

Limiti di frequenza

I limiti si applicano per indirizzo IP. Tutte le risposte includono header di rate limit.

Gli header di rate limit sono inclusi in ogni risposta: X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoint

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

Codici di errore

Tutte le risposte di errore restituiscono un corpo JSON con un error oggetto che descrive il problema.

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