دليل البدء السريع

قم بتحسين وسائطك البصرية وارفع درجات Core Web Vitals (LCP وCLS) في 4 خطوات بسيطة فقط.

الانطلاق في 4 خطوات

الخطوة 1: احصل على مفتاح واجهة برمجة التطبيقات

سجل الدخول إلى لوحة تحكم SmallPict عبر المصادقة بدون كلمة مرور برمز OTP على بريدك. من قسم API Keys، أنشئ مفتاحاً جديداً:

• استخدم sp_live_... لبيئات الإنتاج المباشرة.
• استخدم sp_test_... للتطوير المحلي واختبارات CI/CD الآلية.

الخطوة 2: اختر طريقة التكامل

الخيار أ: إضافة WordPress

قم بتثبيت الإضافة الرسمية من دليل إضافات WordPress أو ارفع ملف ZIP. ضع مفتاح sp_wp_... في الإعدادات > SmallPict وفعل التحويل التلقائي إلى WebP/AVIF.

الخيار ب: حزم SDK للواجهة الخلفية أو الأمامية

قم بتثبيت الحزمة الرسمية المتوافقة مع لغة البرمجة الخاصة بك:

# Node.js & TypeScriptnpm install @smallpict/sdk
# Golanggo get github.com/smallpict/smallpict-go
# Pythonpip install smallpict
# PHP (Composer)composer require smallpict/smallpict-php
# Rust (Cargo)cargo add smallpict
# Ruby (Bundler)gem install smallpict

الخطوة 3: نفذ أول عملية تحسين

تحقق من اتصالك بالواجهة البرمجية عبر أمر cURL التالي:

curl -X POST https://api.smallpict.app/v1/optimize \  -H "X-API-Key: sp_sdk_9a8b7c6d5e4f..." \  -H "X-Timestamp: 1716301234" \  -H "X-Signature: 3a9f8b2c4d6e8a..." \  -H "Content-Type: application/json" \  -d {  "filename": "hero.jpg",  "mime_type": "image/jpeg",  "filesize": 2508800,  "options": {    "format": "avif",    "quality": 80,    "max_width": 1920  }}'

الخطوة 4: تحقق من النتيجة

ستعيد واجهة برمجة التطبيقات كائن JSON يحتوي على رابط الصورة المحسنة ونسبة التوفير المحققة:

{  "success": true,  "data": {    "job_id": "job_9a8b7c6d5e4f",    "status": "completed",    "original_size": 2508800,    "optimized_size": 312400,    "savings_percentage": 87.54,    "format": "avif",    "url": "https://cdn.smallpict.app/media/hero.avif"  }}

الإعدادات الافتراضية الموصى بها