API

ملخص

يتيح لك Convert2WebP API تحويل الصور بين التنسيقات برمجيًا. أرسل طلبًا متعدد الأجزاء مع صورتك واستلم الملف المحول في نص الاستجابة. تتم جميع عمليات المعالجة من جانب الخادم مع زمن وصول أقل من الثانية لمعظم الملفات.

المصادقة

لا يلزم المصادقة. API مجاني ومفتوح. يقتصر معدل جميع الطلبات على 60 طلبًا في الدقيقة لكل عنوان IP.

حدود معدل الاستخدام

يتم تطبيق حدود الأسعار لكل عنوان IP. تتضمن كافة الاستجابات رؤوس حدود المعدل.

يتم تضمين رؤوس حدود المعدل في كل رد: X-RateLimit-Remaining, X-RateLimit-Reset.

نقاط الوصول

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

رموز الأخطاء

تقوم كافة استجابات الأخطاء بإرجاع نص JSON مع error كائن يصف الخطأ الذي حدث.

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