تخطي إلى المحتوى
POST AI agent ready /v1/useragent/parse

User Agent Parser API - اكتشاف المتصفح ونظام التشغيل والجهاز

يقوم بتوزيع سلسلة وكيل المستخدم في مكونات المتصفح والمحرك ونظام التشغيل والجهاز. يكتشف الروبوتات والزواحف والمتصفحات مقطوعة الرأس. إذا لم يتم توفير حقل user_agent، فسيتم استخدام رأس وكيل المستخدم الخاص بالمتصل.

Parameters

stringrequired

User agent string to parse.

Code examples

curl -X POST https://api.botoi.com/v1/useragent/parse \
  -H "Content-Type: application/json" \
  -d '{"user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"}'

When to use this API

إنشاء لوحة تحكم توافق المتصفح

قم بتحليل سلاسل وكيل المستخدم من سجلات التحليلات الخاصة بك لحساب النسبة المئوية للزوار على كل متصفح وإصدار. حدد متى تنخفض إصدارات المتصفح القديمة إلى ما دون حد الدعم الخاص بك حتى تتمكن من إيقاف عمليات التعبئة المتعددة وتقليل حجم الحزمة.

تصفية حركة مرور الروبوت من مقاييس التحويل

قبل حساب مشاهدة الصفحة أو حدث الاشتراك، قم بتحليل وكيل المستخدم وتحقق من علامة is_bot. استبعد زيارات الروبوت من تقارير مسار التحويل للحصول على أرقام دقيقة للزائرين الحقيقيين.

خدمة الاستجابات المحسنة للجهاز

قم بتحليل وكيل المستخدم على الحافة لتحديد ما إذا كان الزائر موجودًا على الهاتف المحمول أو الجهاز اللوحي أو سطح المكتب. يمكنك إرجاع حمولة أخف لمستخدمي الأجهزة المحمولة أو إعادة توجيه زوار الأجهزة اللوحية إلى تخطيط محسّن باللمس.

Frequently asked questions

ما أنواع الروبوتات التي تكتشفها نقطة النهاية هذه؟
فهو يكتشف برامج زحف محركات البحث (Googlebot وBingbot) وروبوتات الوسائط الاجتماعية (Twitterbot وFacebot) وأدوات المراقبة والمتصفحات بدون رأس (Puppeteer وPlaywright) ومكتبات الاستخراج الشائعة.
ماذا يحدث إذا كانت سلسلة وكيل المستخدم مشوهة؟
يستخرج المحلل اللغوي أكبر قدر ممكن من المعلومات. يتم إرجاع الحقول التي لا يمكن تحديدها كقيمة خالية. لا تُرجع نقطة النهاية خطأً للسلاسل غير المعروفة.
هل يمكنني معرفة الشركة المصنعة للجهاز؟
نعم. يتضمن كائن الجهاز البائع (مثل Apple وSamsung وGoogle) والطراز (مثل iPhone وGalaxy S24) عندما يحتوي وكيل المستخدم على تلك المعلومات.
هل يعمل هذا مع وكلاء المستخدم غير المستعرضين؟
نعم. يتعامل مع وكلاء المستخدم من طلبات curl وPostman وPython ومكتبات HTTP الأخرى. يتم تحليلها مع اسم الأداة وإصدارها.
ماذا لو لم أرسل حقل user_agent؟
تقوم نقطة النهاية تلقائيًا بتوزيع رأس وكيل المستخدم من طلب HTTP الخاص بك. يتيح لك هذا اكتشاف المتصفح والجهاز الخاص بالعميل الخاص بك دون استخراج الرأس بنفسك.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.