نظرة عامة على لوحة التحكم
لوحة تحكم FourA هي المكان الذي تدير فيه مفاتيح API ومستخدمي proxy، وتجري فيه طلبات الاختبار، وتراقب الأداء، وتتعامل مع الفواتير، وتضبط إعدادات حسابك. تستعرض هذه الصفحة شاشة Overview الرئيسية وأقسام الشريط الجانبي.
الوصول إلى لوحة التحكم
سجل الدخول عبر foura.ai/dashboard. تحتاج إلى حساب FourA: سجل هنا إذا لم يكن لديك حساب.
منتجان، مجموعة صفحات واحدة
يفتح كل من Overview وMetrics وActivity على مفتاح تبديل Product مع خيارين:
| Product | ما يتم احتسابه | الوحدة |
|---|---|---|
| API | الطلبات التي ترسلها إلى /api/single و/api/proxy و/api/browser و/api/auto |
الطلبات والأرصدة |
| Proxy | الأنفاق التي تفتحها أدواتك عبر proxy.foura.ai |
الأنفاق والبايتات |
ينقل النفق كل ما يرسله عميلك من خلاله، وما يحدث داخل CONNECT هو حركة مرور مشفرة خاصة بك. لذلك تحتسب طرق عرض Proxy الأنفاق والبايتات ولا تحتسب الطلبات أو الأرصدة أبدا. اقرأ منفذ Proxy لمعرفة تفاصيل المنتج نفسه.
يكون مفتاح التبديل دائما على أحد الخيارين، ويتم تذكره بين الزيارات، ويظهر في العنوان كـ #overview/proxy أو #metrics/proxy أو #activity/proxy. الصق أحد هذه الروابط وستفتح الصفحة على ذلك المنتج.
لا تخلط بين منتج Proxy وشريحة endpoint المسماة Proxy Finder. إن Proxy Finder هو POST /api/proxy/، وهو أحد نقاط نهاية API الأربع. أما منتج Proxy فهو منفذ الـ proxy.
صفحة Overview، منتج API
تعرض الصفحة المقصودة بعد تسجيل الدخول أرقامك الرئيسية للفترة التي تحددها. يتم إعادة تحميل الصفحة تلقائيا كل 60 ثانية، ويعرض زر التحديث بجوار العنوان العد التنازلي ويعيد التحميل على الفور.
قبل طلبك الأول
حتى يصل طلبك الأول، تعرض واجهة API بيانات تجريبية، مع وسم Sample على كل لوحة ومخطط بياني، تحت شريط This is sample data. الذي يتضمن خطوتين: Create API key، حيث يفتح المفتاح الجديد مع أمر اختبار، وOpen Playground لإرسال طلب. على الهاتف أو الجهاز اللوحي، توجهك الخطوات إلى Playground، لأن الهاتف لا يمكنه تشغيل الأمر. يحل طلبك الحقيقي الأول محل البيانات التجريبية نهائيا.
تحتوي واجهة Proxy على شريط خاص بها بعنوان No traffic yet. يتضمن Create proxy user وOpen Proxy، ويظهر حتى ينقل أحد مستخدمي proxy حركة مرور أو يصل أول طلب API حقيقي لك. يؤدي إغلاق أي من الشريطين إلى إخفاء كليهما.
بطاقات الملخص
ست لوحات في الجزء العلوي:
| اللوحة | ما تعرضه |
|---|---|
| التزامن (Concurrency) | طلبات قيد التشغيل في الوقت نفسه الآن، بالإضافة إلى المتوسط والحد الأقصى للفترة |
| الطلبات (Requests) | إجمالي الاستدعاءات، ثم Single وProxy وBrowser وAuto، مع حصة كل منها من الإجمالي أدناه. يُحسب استدعاء Auto مرة واحدة فقط، تحت Auto. |
| محاولات Auto | تظهر دائمًا، مع أصفار إذا لم يُشغّل Auto أي شيء خلال الفترة. طلبات Single وProxy وBrowser التي أجراها Auto خلف استدعاءات Auto الخاصة بك، مع المحاولات لكل استدعاء Auto. لا تُحسب أبدًا كطلبات أو ضمن معدل النجاح، وتوجد أرصدتها ضمن أرصدة Auto. ولكنها تُحتسب ضمن حدود المعدل (rate limits) وحدود التزامن لـ Single وProxy وBrowser. |
| الرصيد (Credits) | الرصيد المفوتر كقيمة، والرصيد المستهلك تحته، للإجمالي ولكل منتج، بما في ذلك Auto |
| البايتات (Bytes) | البيانات المنقولة: الوارد (In) هو ما أرسلته، والصادر (Out) هو ما تم استلامه، والمميز (Premium) هو جزء من حركة المرور هذه التي مرت عبر مخرج مميز، سواء نجح هذا المخرج في تسليم الصفحة أم لا. يقع Premium ضمن الإجماليين ولا يُضاف إليهما أبدًا. |
| وقت الاستجابة (Response Time) | المتوسط والحد الأدنى والحد الأقصى عبر الفترة |
المفوتر والمستهلك رقمان مختلفان. يُفوتر الطلب الناجح فقط، لذا فإن المفوتر هو ما تدفع مقابله. أما المستهلك فهو كل نتيجة، لأن الطلب الفاشل يظل يستهلك proxy أو متصفحًا. قراءة أحدهما باسم الآخر هو السبب وراء ظهور الحساب نفسه كأنه حسابان مختلفان في صفحتين مختلفتين. راجع نتائج الطلبات لمعرفة أي النتائج يتم فوترتها.
تُسمي لوحتا Requests وCredits نقاط النهاية (endpoints) الأربع بـ Single وProxy وBrowser وAuto. صف تصفية Endpoints الموجود أعلاها يُطلق على Proxy اسم Proxy Finder، وهو الشيء نفسه: POST /api/proxy/.
لا يتطابق مجموع الأربعة دائمًا مع الإجمالي. يحمل عدد قليل من الاستدعاءات أياً منها، ويتم احتسابها في الإجمالي ولا تتبع أي endpoint.
مخططات المخطط الزمني
أسفل اللوحات، تعرض ستة مخططات زمنية حجم الطلبات، واستهلاك الرصيد، وتفصيل النتائج، ووقت الاستجابة، والنطاق الترددي، والتزامن. يحتوي كل مخطط على مفتاح تبديل في رأسه يستبدل الرسم البياني بالجدول الأساسي.
صفحة النظرة العامة، منتج Proxy
قم بتبديل Product إلى Proxy وستعرض الصفحة نفسها البيانات عبر الأنفاق (tunnels). أربع لوحات:
| اللوحة | ما تعرضه |
|---|---|
| الأنفاق المتزامنة (Tunnels at Once) | الأنفاق المفتوحة في اللحظة نفسها. يغطي الحالي (Current) الثواني القليلة الماضية ويتم تحديثه كل خمس ثوانٍ؛ ويغطي المتوسط (Avg) والحد الأقصى (Max) الفترة كاملة. خطتك تحدد هذا عبر جميع مستخدمي proxy معًا. |
| الأنفاق (Tunnels) | الناجحة والفاشلة، مع حصة كل منها من الإجمالي. الفاشلة هي كل نتيجة أخرى، ويوضح صف Outcome نوعها. |
| حركة المرور (Traffic) | الوارد (In) هو ما أرسلته أدواتك، والصادر (Out) هو ما تم استلامه، والمميز (Premium) هو الجزء الذي خرج عبر الشبكة المميزة، ويُحسب ضمن الإجماليات بدلاً من إضافته إليها. |
| وقت الإعداد (Setup Time) | متوسط وحد أدنى وحد أقصى لفترة الانتظار قبل تسليم النفق، على الأنفاق الناجحة فقط. إنه وقت الانتظار قبل أول بايت خاص بك، وليس سرعة الموقع خلف النفق. |
توجد خمسة مخططات زمنية أسفلها: Tunnel Timeline وOutcome Timeline وSetup Time Timeline وTraffic Timeline وTunnels at Once Timeline. يتضمن كل واحد منها نفس مفتاح التبديل بين المخطط البياني والجدول مثل مخططات API البيانية.
تصبح ثلاث لوحات ومخططاتها الزمنية خافتة عند تفعيل حبة Outcome، والسبب في كل حالة هو أن الرقم غير موجود لتلك النتيجة. تصبح لوحة Tunnels at Once خافتة تحت أي نتيجة، ويحمل مخططها شارة Not filterable. تصبح لوحتا Setup Time وTraffic خافتتين تحت نتيجة الفشل، وتحمل مخططاتهما شارة Success only، لأن النفق الفاشل لم يتم تسليمه أبدا ولم ينقل أي بيانات.
Period وDetail
تحدد Period المدى الزمني للماضي الذي تبحث فيه. ثماني حبات بالإضافة إلى Custom:
| الحبة | النافذة الزمنية |
|---|---|
| 30M | آخر 30 دقيقة |
| 3H | آخر 3 ساعات |
| 12H | آخر 12 ساعة |
| 24H | آخر 24 ساعة |
| 7D | آخر 7 أيام |
| 30D | آخر 30 يوما |
| 90D | آخر 90 يوما |
| 1Y | آخر 12 شهرا |
يفتح الخيار Custom نافذة حوارية تتضمن أربعة إعدادات مسبقة: This month وLast month وLast 6 months وAll time، بالإضافة إلى زوج من تواريخ From وTo. يمتد النطاق الزمني حتى نهاية اليوم الذي حددته، ولا يتجاوز اللحظة الحالية أبدا.
تحدد Detail عرض كل شريط: لكل دقيقة، أو كل 5 دقائق، أو كل 30 دقيقة، أو كل ساعة، أو كل 6 ساعات، أو يوميا، أو أسبوعيا، أو شهريا. القيمة الافتراضية هي Auto، والتي تختار أوسع خطوة تظل تعرض 15 شريطا على الأقل في المخطط البياني، بحيث تظهر السنة كشكل بياني بدلا من 365 خطا دقيقا. يوضح الخيار Auto الخطوة التي تم اختيارها.
ينطبق خيارا Period وDetail على كلا المنتجين.
تظهر خطوات Detail التي تعود إلى مدى زمني أبعد مما تحتفظ به FourA لتلك الدقة بلون رمادي بدلا من إخفائها:
| الدقة | مدى الرجوع إلى الماضي |
|---|---|
| Per-request | 7 أيام |
| 5-minute | 30 يوما |
| Hourly | 12 شهرا |
| Daily | السجل الكامل |
اختر فترة زمنية أقدم مما يسمح به مستوى معين وستتحول الخيارات الأكثر دقة إلى اللون الرمادي. لا يختار الخيار Auto أيا منها أبدا، لذا لن يكون المخطط البياني فارغا بسبب تجميع البيانات وتلخيصها.
عوامل التصفية
تتراكم عوامل التصفية وتتكامل معا، ويوجد بجانبها خيارا Period وDetail.
| عامل التصفية | المنتج | الوظيفة |
|---|---|---|
| Product | كلاهما | API أو Proxy |
| Endpoints | API | تحديد النطاق لنقطة نهاية واحدة: Single أو Proxy Finder أو Browser أو Auto. يُحسب استدعاء Auto مرة واحدة فقط تحت Auto؛ وتظهر طلبات Single وProxy وBrowser التي نفذها تدرجه في الخلفية بالاسم داخل لوحة محاولات Auto، ولا تظهر مطلقا كطلبات مستقلة بذاتها. |
| Outcome | كلاهما | عزل فئة واحدة. يوفر API جميع الفئات السبع؛ بينما يوفر منتج Proxy الحالات الخمس التي يمكن أن ينتهي بها النفق. |
| Owner | كلاهما | Everything أو Personal أو إحدى مؤسساتك. يظهر فقط عندما تنتمي إلى مؤسسة واحدة على الأقل. |
| Key | API | التقييد بمفتاح API واحد |
| Proxy user | Proxy | التقييد بمستخدم proxy واحد |
لا تقبل لوحة Concurrency ومخططها البياني في جانب API عاملي التصفية Endpoints أو Outcome. يصبح كلاهما خافتا أثناء تفعيل أي منهما، ويوضح المخطط البياني ذلك في عنوانه.
عامل التصفية Owner
تحدد القائمة المنسدلة Owner إجابة السؤال "حركة مرور من التي أشاهدها حاليًا؟". وتوفر خيارات Everything وPersonal ومدخلًا واحدًا لكل مؤسسة تنتمي إليها، كما يتبع نفس عنصر التحكم في صفحات Metrics وActivity وAPI Keys وProxy اختيارك، حتى لا تتعارض الصفحات أبدًا.
لا تتضمن صفحتا Usage & Limits وBilling هذا الخيار عن قصد. فهما تجيبان عن السؤال "ما الذي يُحسب عليّ في الفاتورة؟"، وهو ما يمثل بالنسبة لك مفاتيحك الشخصية ومستخدمي الـ proxy التابعين لك بالإضافة إلى المؤسسات التي تمتلكها. راجع Organizations.
أقسام الشريط الجانبي
إحدى عشرة صفحة ورابط Docs، مقسمة إلى أربع مجموعات: Dashboard وTools وAccess وAccount.
Dashboard: Overview وMetrics وActivity
الصفحات الثلاث التي تجيب عن السؤال "ما الذي حدث؟". وتحتوي جميعها على مفتاح تبديل Product.
Overview هي الصفحة المذكورة أعلاه، وهي دائمًا نقطة البداية بعد تسجيل الدخول.
تحتوي صفحة Metrics على لوحة الاستخدام Usage: تفصيل مجمّع حسب مفتاح API أو IP العميل أو النطاق في جانب API، وحسب مستخدم الـ proxy أو الوجهة أو بلد الخروج أو IP العميل أو النتيجة في جانب Proxy، مع بطاقات للفترة بأكملها أعلى جدول متعدد الصفحات. راجع دليل Metrics.
تعرض صفحة Activity آخر ساعة من حركة المرور. ويتم تحميلها عند فتح الصفحة، بينما يجلب زر التحديث أحدث الصفوف. في جانب API، يمثل كل صف request واحدًا: الطريقة، ونطاق الوجهة، والحالة، والنتيجة، والمدة، وحجم النقل، والأرصدة. وفي جانب Proxy، يمثل كل صف نفقًا واحدًا: مستخدم الـ proxy، والوجهة، ونقطة الخروج، والنتيجة، والإعداد، والمدة، ووحدات البايت، وIP العميل. راجع Activity Log.
Tools: Playground وExtension وDocs
اختبر طلبات حية باستخدام مفتاح API الفعلي الخاص بك دون كتابة أي كود. اختر Auto أو Single أو Proxy أو Browser، وحدد URL، واضبط الإشارات والمهل الزمنية، واضغط على Send. احفظ الإعدادات الشائعة كإعدادات مسبقة، وأعد تشغيل أي من آخر 20 عملية تشغيل لك من History.
يُحتسب الاستخدام من الحصة المخصصة للمفتاح، تمامًا كما هو الحال مع أي استدعاء في بيئة الإنتاج. راجع دليل Playground.
صفحة Extension، المميزة بعلامة Beta، هي المكان الذي تنزّل منه إضافة FourA لمتصفح Chrome. توجه نافذتها المنبثقة متصفح Chrome عبر أحد مستخدمي الـ proxy لديك، كما تحول علامة تبويب FourA في DevTools أي request تنشئه الصفحة إلى استدعاء API جاهز. راجع Chrome Extension.
يفتح رابط Docs هذا التوثيق في علامة تبويب جديدة، مما يحافظ على صفحة لوحة التحكم التي تتصفحها حاليًا دون تغيير.
يتنقل زر المظهر في أعلى الشريط الجانبي بين إعداد جهازك، والوضع الفاتح، والوضع الداكن. وتتم مشاركة هذا الاختيار مع foura.ai وصفحات التوثيق، وبالتالي فإن أي مظهر تحدده في أي منها يُطبق على لوحة التحكم.
Access: API Keys وProxy
تتيح لك صفحة API Keys إنشاء المفاتيح التي تستخدمها تطبيقاتك للاتصال بـ API وعرضها وإدارتها. تستخدم المفاتيح البادئة pk_live_. راجع Managing API Keys.
Proxy هو المكان الذي تُنشئ فيه مستخدمي proxy وتنسخ سلسلة اتصال لأي عميل يقبل proxy URL. يتم احتساب الأنفاق وحركة البيانات عبر المنفذ ضمن خطتك، تماماً مثل API. راجع Proxy Users ومرجع Proxy Port.
Account: Organizations وUsage & Limits وBilling وSettings
تتيح Organizations مشاركة مفاتيح API ومستخدمي proxy مع الزملاء تحت مالك واحد. أضف الأشخاص عبر البريد الإلكتروني، وحدد دورهم، وانقل ملكية المؤسسة عند الحاجة إلى تغيير المالك. يُحتسب الاستخدام عبر بيانات اعتماد المؤسسة ضمن خطة مالك المؤسسة. راجع Organizations.
تعرض صفحة Usage & Limits خطتك، وما استخدمته خلال فترة الفوترة الحالية، وكل حد يتم قياسك بناءً عليه، مع تفصيل لكل مفتاح ولكل endpoint ولكل مستخدم proxy. راجع Usage & Limits.
تُدير صفحة Billing اشتراكك، وتتيح شراء المزيد من الرصيد أو ترافيك البيانات، وتحفظ وسائل الدفع والفواتير، وتوضح الرصيد وترافيك البيانات والترافيك المميز لهذه الفترة مقارنة بخطتك. راجع Billing & Subscriptions.
تحتوي صفحة Settings على اسم العرض، وكلمة المرور، والجلسات النشطة، وموفري تسجيل الدخول المتصلين. لا يمكن تغيير البريد الإلكتروني من لوحة التحكم: تواصل مع الدعم الفني.
نصائح
- استخدم Playground قبل كتابة الشيفرة البرمجية. إذا كنت لا تعرف المحرك الذي يحتاجه موقع جديد، ابدأ بالخيار Auto ودعه يحدد ذلك.
- قارن بين المفوتر والمستهلك في بطاقة الرصيد. إذا كان الفرق كبيراً بين الاثنين في endpoint معين، فهذا يعني أنه يفشل كثيراً، ويوضح attempt report سبب ذلك.
- في منتج Proxy، تشير كتلة Rate Limited في مخطط Outcome Timeline إلى حدود خطتك، وليس رفضاً من الموقع الهدف. يحدد عرض Outcome في Metrics الحد المعني بالتحديد.
- حافظ على أمان مفاتيح API ومستخدمي proxy. عطل أياً منهما فوراً إذا شككت في تعرضه للاختراق.
الخطوات التالية
- Authentication: تفاصيل إنشاء مفتاح API وإدارته
- Quick Start: نفّذ أول request لك عبر CLI
- How Your Plan Is Metered: الرصيد وحركة البيانات والحد الأقصى الذي ينطبق عليك
- Usage & Limits: تتبع الرصيد وحركة البيانات مقارنة بخطتك
- API Endpoints: استخدم API مباشرة