Skip to content
SEO Optimizer is live, Audit on page SEO and AI-search readiness. Try it free
تسجيل الدخول
Website Audit

مرجع API

تدقيق الموقع الإلكتروني

يُجري تدقيقًا كاملًا للموقع ويُرجع درجات الأداء وSEO وإمكانية الوصول وأفضل الممارسات (من 0 إلى 100 لكل منها) مع إصلاحات مولَّدة بالذكاء الاصطناعي مخصصة للتقنيات المكتشفة.

POST/api/auditsynchronous

نتائج الأداء، ومشكلات SEO، وتوصيات الذكاء الاصطناعي

نص الطلب

{
  "url": "https://example.com",
  "budget": { ... }   // optional, see below
}

الاستجابة

{
  "reportId": "clxyz...",
  "url": "https://example.com",
  "performanceScore": 91,
  "seoScore": 87,
  "accessibilityScore": 100,
  "bestPracticesScore": 95,
  "issues": [...],
  "recommendations": [...],
  "fixes": [...],
  "aiSummary": "...",
  "techStack": [...],
  "perfBudget": { ... },
  "budgetViolations": [...]  // when a budget was sent
}

مثال

curl -X POST https://www.scanverra.com/api/audit \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

ميزانيات الأداء

تتضمن كل استجابة من API الحقل perfBudget: حدود مبنية على هذا التدقيق (+10% أو هامش أدنى) والخدمات الخارجية التي وُجدت. احفظه ثم أرسله باسم budget في عمليات التدقيق التالية لتحصل على budgetViolations: كل ما أصبح أبطأ أو أثقل أو خدمة خارجية جديدة. تقوم CLI بذلك عبر scanverra audit --save-budget و--budget.

"perfBudget": {
  "version": 1,
  "device": "desktop",
  "metrics": { "lcp": 2600, "tbt": 250, "cls": 0.05, "fcp": 1400 },
  "transferBytes": 1843200,
  "scriptBytes": 921600,
  "requestCount": 62,
  "vendors": ["Google Analytics", "Hotjar"]
}

"budgetViolations": [
  { "key": "lcp", "limit": 2600, "actual": 3120 },
  { "key": "vendor", "limit": "not in budget", "actual": "Intercom" }
]

إعادة التدقيق في الخطة المجانية

تحصل الحسابات المجانية على 5 عمليات تدقيق شهريًا دون انتظار. بعد ذلك، تؤدي إعادة تدقيق الموقع نفسه خلال 15 دقيقة إلى 429 مع code: "SCAN_COOLDOWN" وترويسة Retry-After (بالثواني). الخطط المدفوعة لا تنتظر أبدًا.

معيار احتساب النتائج

تتراوح كل درجة بين 0 و100. تعتبر واجهة Scanverra ≥90 جيدة و50-89 بحاجة إلى تحسين و<50 ضعيفة. لا توجد عتبة نجاح/رسوب مدمجة في نقطة النهاية هذه — اختر العتبة المناسبة لكل درجة عند استخدامها في مسار عمل (راجع تكامل CI/CD).