Website Audit
مرجع API
تدقيق الموقع الإلكتروني
يُجري تدقيقًا كاملًا للموقع ويُرجع درجات الأداء وSEO وإمكانية الوصول وأفضل الممارسات (من 0 إلى 100 لكل منها) مع إصلاحات مولَّدة بالذكاء الاصطناعي مخصصة للتقنيات المكتشفة.
/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).