توثيق Image Optimizer

قم بتحويل الصور إلى WebP أو AVIF أثناء الطلب وقدمها من CDN موزع على 12 مدينة. إضافة WordPress جاهزة، امتداد Plesk، أو REST API.

https://image-optimizer.api.jetweb.appREST APIمستضاف في الاتحاد الأوروبي

نظرة عامة

يقبل API Image Optimizer عنوان URL للصورة المصدر (أو رفعًا) ويعيد نسخة محسنة بصيغة WebP أو AVIF. تظل عناوين URL الحالية للصور على موقعك تعمل — يقوم المحسن بإعادة كتابتها بشكل كسول عبر إضافة WordPress أو عبر قاعدة حافة على CDN الخاص بك.

بداية سريعة

أرسل طلب POST مع عنوان URL المصدر والصيغة المستهدفة. يحتوي الرد على عنوان URL المحسن لـ CDN الذي يمكنك تضمينه في HTML الخاص بك.

bash

curl -X POST https://image-optimizer.api.jetweb.app/api/optimize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "format": "webp",
    "quality": 80
  }'

المصادقة

تتطلب كل نقطة نهاية API رمز Bearer. قم بإنشاء واحد في لوحة التحكم ضمن "مفاتيح API" للمنتج ذي الصلة. احتفظ بالرموز من جانب الخادم — لا تلتزم بها أبدًا في المستودعات العامة أو تشحنها في حزم الواجهة الأمامية.

bash

Authorization: Bearer YOUR_API_KEY

نقاط النهاية

عنوان URL الأساسي: https://image-optimizer.api.jetweb.app

POST

/api/optimize

تحسين صورة واحدة. يقبل url، format (webp/avif)، quality (1–100)، وعرض/ارتفاع اختياريين.

GET

/api/history

عرض قائمة بالصور المحسنة مؤخرًا للحساب الموثق.

GET

/api/usage

إرجاع الحصة الحالية للاستخدام والبدل المتبقي للحساب الموثق.

GET

/api/cdn/:domain/:path

جلب أصل محسن مباشرة من CDN. مفيد للاختبار؛ يجب على عملاء الإنتاج تضمين عنوان URL CDN الذي تم إرجاعه.

التكاملات

قم بتثبيت إضافة WordPress من wordpress.org، أو قم بتفعيل امتداد Plesk. للمكدسات المخصصة، اتصل بـ REST API مباشرة — أي مكتبة عميل يمكنها إرسال JSON POST ستعمل.