توثيق API

استخدم الـ API لتكامل PLAGN مع أدواتك.

🔐 المصادقة

أرسل مفتاح API في الـ header لكل طلب محمي:

X-API-Key: your_api_key_here

📡 النقاط المتاحة

GET /api.php?action=status

فحص حالة الـ API — بدون مصادقة.

{
  "status": "online",
  "version": "2.0.0",
  "name": "PLAGN"
}

GET /api.php?action=layouts

قائمة التخطيطات المتاحة — بدون مصادقة.

GET /api.php?action=themes

قائمة المظاهر — بدون مصادقة.

GET /api.php?action=fonts

قائمة الخطوط المدعومة — بدون مصادقة.

POST /api.php?action=generate يتطلب مصادقة

إنشاء تكوين صور شاشات للتطبيق.

الحقول المطلوبة:

الحقل	النوع	مطلوب	الوصف
app_name	string	✅	اسم التطبيق
headline	string	✅	العنوان التسويقي
layout	string	❌	التخطيط (افتراضي: center)
theme	string	❌	المظهر (dark/light/gradient)
font	string	❌	الخط
language	string	❌	اللغة (ar/en)
palette	array	❌	ألوان مخصصة (5 hex)

مثال (cURL):

curl -X POST "https://your-domain.com/api.php?action=generate" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "app_name": "تطبيقي",
    "headline": "أفضل تطبيق للإنتاجية",
    "layout": "floating",
    "theme": "dark"
  }'

⚠️ حدود الاستخدام

100 طلب/ساعة

الحد الأقصى لنقطة generate

JSON