مستندات Image Optimizer

تصاویر را به صورت لحظه‌ای به WebP یا AVIF تبدیل کنید و از یک CDN در ۱۲ شهر ارائه دهید. افزونه 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" برای محصول مربوطه ایجاد کنید. توکن‌ها را در سمت سرور نگه دارید — هرگز آن‌ها را در مخازن عمومی commit نکنید یا در بسته‌های فرانت‌اند ارسال نکنید.

bash
Authorization: Bearer YOUR_API_KEY

نقاط پایانی

URL پایه: https://image-optimizer.api.jetweb.app

POST
/api/optimize
بهینه‌سازی یک تصویر. url، فرمت (webp/avif)، کیفیت (۱–۱۰۰) و عرض/ارتفاع اختیاری را می‌پذیرد.
GET
/api/history
فهرست تصاویر بهینه‌سازی شده اخیر برای حساب احراز هویت شده.
GET
/api/usage
سهمیه استفاده فعلی و مجوز باقی‌مانده برای حساب احراز هویت شده را برمی‌گرداند.
GET
/api/cdn/:domain/:path
دریافت مستقیم یک دارایی بهینه‌سازی شده از CDN. مفید برای تست؛ مشتریان تولیدی باید URL CDN برگشتی را جاسازی کنند.

ادغام‌ها

افزونه WordPress را از wordpress.org نصب کنید، یا افزونه Plesk را فعال کنید. برای پشته‌های سفارشی، مستقیماً REST API را فراخوانی کنید — هر کتابخانه کلاینت که می‌تواند JSON POST کند کار خواهد کرد.