بيئة التجربة

يتيح لك Playground (الشريط الجانبي > Playground) تشغيل طلبات API حية باستخدام مفتاحك الفعلي دون كتابة أي كود. إنها أسرع طريقة لتجربة موقع هدف جديد، أو تصحيح أخطاء response معقد، أو مقارنة Auto وSingle وProxy وBrowser جنبا إلى جنب.

افتحه عبر foura.ai/dashboard#playground.

ما يوفره لك

نموذج واحد. أربعة محركات. حركة مرور فعلية.

  • Auto: جلب ذكي. تقوم بتمرير URL مع قاعدة validate ويختار FourA المسار الأقل تكلفة الذي يعمل بنجاح.
  • Single: جلب HTTP مباشر بخصائص شبكية واقعية تشبه المتصفح
  • Proxy: جلب عبر proxy مدار بتدوير تلقائي، مع إمكانية تحديد البلد الظاهر للموقع الهدف اختياريا
  • Browser: يفتح الـ URL في مثيل متصفح Chrome للمواقع التي تعتمد على عرض JS

تُنفذ الطلبات باستخدام مفتاح API الذي تحدده في أعلى الصفحة. ويُحسب الاستخدام من حصة هذا المفتاح تماما كما يحدث مع طلبات الإنتاج، لذا تجنب استنزاف باقتك أثناء الاختبار.

اختيار مفتاح

تعرض القائمة المنسدلة لمفاتيح API كل مفتاح نشط يمكنك استخدامه: مفاتيحك الخاصة تحت My Keys، ثم مجموعة لكل مؤسسة تنتمي إليها. يمكن لأي عضو تشغيل مفتاح المؤسسة، ويُحسب أي طلب يُنفذ باستخدامه من خطة مالك المؤسسة. اختر المفتاح الذي تريد محاسبة الطلب بناء عليه. إذا لم يكن لديك أي مفاتيح نشطة بعد، فسيظهر رابط مباشر ينقلك إلى صفحة API Keys لإنشاء واحد.

اختيار الوضع

يبدل صف Mode العلوي بين Auto والمحركات اليدوية. عند تحديد Auto، ينتقل النموذج إلى واجهة Auto المبسطة (URL بالإضافة إلى validate وبعض خيارات التحكم الإضافية). يظهر كلا الصفين دائما: Mode: Auto، وEndpoint: Single، Proxy، Browser. يؤدي اختيار أحدهما إلى إلغاء تحديد الآخر. يؤدي تبديل الـ endpoint إلى تغيير الحقول المرئية والمحرك الذي يتلقى الطلب. يُحفظ التحديد الحالي عند إعادة تحميل الصفحة.

Mode متى تستخدمه
Auto موقع هدف جديد أو ذو حماية مختلطة. يختار Auto المسار الأقل تكلفة ويتذكر ما يعمل بنجاح.
Single جلب HTTP سريع. أفضل خيار أول لمضيف معروف.
Proxy الجلب نفسه مع تدوير تلقائي للـ proxy. عيّن exitCountries عندما تحتاج إلى بلد ظاهر للموقع الهدف.
Browser يحمل الصفحة في مثيل متصفح Chrome. يُستخدم عندما لا تظهر البيانات إلا بعد تشغيل JavaScript.

بناء الطلب

صف URL

يحتوي الصف العلوي على طريقة HTTP (مثل GET وPOST وPUT وPATCH وDELETE وHEAD وOPTIONS)، وURL الهدف، وزر Send. تدعم أوضاع Single وProxy وAuto جميع الطرق. يتجاهل Browser الطريقة (حيث يصدر Chrome دائما GET للتنقل) والـ body.

علامات تبويب الطلب

أسفل صف URL، تتيح لك خمس علامات تبويب ملء كل شيء آخر:

علامة التبويب ما تتحكم فيه
UI حقول النموذج لمهلات الانتظار (timeouts)، وإعادة التوجيه (redirects)، والأعلام (flags)، والـ proxy، والخيارات المخصصة للمتصفح، وقواعد validate
Body نص حر (body) لطلبات POST / PUT / PATCH
Headers ترويسات request مخصصة كأزواج مفتاح وقيمة
Cookies وعاء ملفات تعريف ارتباط (cookie jar) محفوظ لكل مضيف في هذا المتصفح. يربط خيار Use jar ملفات الـ cookie المطابقة بالطلب، بينما يحفظ خيار Save response cookies الملفات التي يحددها الـ response. كلاهما مفعّل افتراضياً، وتعرض علامة التبويب معاينة لما سيرسله هذا الـ request
Raw حمولة JSON الدقيقة التي سيتم إرسالها، كمعاينة للقراءة فقط مع خيار Copy JSON، بالإضافة إلى أمر cURL لإعادة إنتاج الطلب أسفلها

تنعكس أي تغييرات تجريها في UI / Body / Headers / Cookies تلقائياً في Raw. لا يمكنك الكتابة داخل Raw: قم بتعديل الـ request من علامات التبويب الأخرى. تظهر نقطة حمراء على أي علامة تبويب أو قسم قابل للطي يحتوي على قيمة تختلف عن الإعدادات الافتراضية للمحرك، مما يتيح لك معرفة ما قمت بتخصيصه بنظرة سريعة.

أقسام جزء UI

تجمع علامة التبويب UI الإعدادات في أقسام قابلة للطي. تستخدم الحقول الفارغة القيمة الافتراضية لمخطط (schema) المحرك. ويتم إخفاء الأقسام التي لا تنطبق على وضع Mode الحالي.

  • مهلات الانتظار: timeout_ms، وconnect_timeout_ms، وaccept_timeout_ms، وserver_response_timeout_ms، وdns_cache_timeout_sec. يعرض Browser وAuto فقط timeout_ms (في Auto، يمثل الميزانية الإجمالية).
  • عمليات إعادة التوجيه: تفعيل وتعيين followRedirects (من 0 إلى 20). متاح لـ Single وProxy. يتبع Browser عمليات إعادة التوجيه تلقائيا بمفرده.
  • الأعلام: unblocker لـ Single وProxy وBrowser (unblocker على Browser يكمل عمليات التحقق التي تطلبها الصفحة)؛ tryJsonData وreturnBuffer لـ Single وProxy. يعرض Auto بدلا من ذلك forceProxy وreturnSession.
  • الوكيل (Proxy): اختر معرف proxy معينا لـ Single أو Browser، أو اضبط maxTries، ومهلة Proxy الخارجية، وexitCountries، وexitClass، وignoreProxies لمحرك Proxy. يعرض Auto أيضا ignoreProxies وexitClass. تتضمن قائمة الاختيار exitClass ثلاث حالات: غير محدد لا يرسل أي حقل على الإطلاق، وstandard يحدد المجموعة القياسية، وpremium يتيح للطلب الترقية إلى مخرج مميز عندما تواجه المجموعة القياسية صعوبات. كل من غير محدد وstandard يظلان ضمن المجموعة القياسية؛ والطلب الناجح الذي يحدد فئة يحصل على exitClass في الرد. يتطلب Premium خطة تتضمن مخارج مميزة: راجع exitClass.
  • ملف تعريف المتصفح: ثلاث قوائم منسدلة متتالية، os، وbrowser، وversion، تعرض ما يمكن لـ FourA تقديمه فعليا. تظهر في وضعي Single وProxy. اتركها فارغة للحصول على أحدث إصدار من Chrome. تضيق كل قائمة اختيارات الخيارين الآخرين، بحيث لا تظهر أبدا تركيبة تؤدي إلى لا شيء. يتطلب هذا القسم تفعيل unblocker: في حال إيقافه لا يتم إرسال أي ترويسات متصفح، ويتم تطبيق ملف التعريف جزئيا فقط، ويرفض الـ API الطلب بدلا من ذلك.
  • المتصفح: خيارات خاصة بالمتصفح فقط مثل checkStatus وcheckText.
  • التحقق: يقبل كل من status accept وstatus fail رموز حالة مفصولة بفواصل (validate.status)، ويقبل كل من body accept وbody fail سلاسل فرعية مع بدائل مفصولة بـ | (validate.data). متاح لـ Single وProxy وAuto. يستخدم Browser بدلا من ذلك checkStatus وcheckText. لا يحتوي النموذج على حقل لقواعد الترويسات (validate.headers).

بمجرد أن يُرجع التشغيل proxy عمل بنجاح، يظهر قسم Working proxies في نهاية علامة تبويب واجهة المستخدم. يسرد ما يصل إلى 20 معرف proxy، الأحدث أولا، كل منها مع بلد الخروج والوقت الخاص به. يقوم خيار use بإدراج أحدها في حقل proxy في Single أو Browser (محرك Proxy يبحث عن خياره بمفرده)، ويحذفه خيار × من القائمة.

تحديد نطاق بلد الخروج (وضع Proxy)

يقبل حقل exitCountries في Proxy قائمة مفصولة بفواصل من رموز البلدان المكونة من حرفين والمرئية للهدف (CZ, GB). يتم اقتطاع المسافات الزائدة، وتحويل الأحرف إلى كبيرة، وإزالة التكرار عند الإرسال. الاختيار من المجموعة القياسية هو قائمة سماح صارمة: يتم استبعاد أجهزة proxy ذات نقاط الخروج غير المعروفة، ولا تلجأ المجموعة مطلقاً إلى بلد آخر كبديل. يتبع مخرج premium هذه القائمة أيضاً. عند تعيين exitClass إلى premium، يخرج مخرج premium من أحد البلدان المدرجة، وأي بلد لا تملك المجموعة القياسية أي خوادم فيه ينتقل إلى مخارج premium هناك. بدون premium، تُرجع المجموعة التي لا تحتوي على أي تطابق رمز code: "no_eligible_proxy" مع إعادة عرض النطاق المطلوب في details.exitCountries. احتفظ بالنطاق وأعد المحاولة لاحقاً.

عند نجاح استدعاء proxy في ظل تحديد النطاق، يعرض شريط response قيمة exit <CODE> بجوار معرف proxy لتتمكن من التحقق من أن البلد الذي تم التقديم منه يطابق ما طلبته.

موقع الخروج (وضع Proxy)

تحدد مجموعة Exit location في Proxy مكان خروج مخرج premium: المنطقة، والمدينة، والشبكة، والجهاز، والمدة التي يحتفظ فيها بعنوانه. تكتمل قوائم المنطقة والمدينة والشبكة عندما يحدد exitCountries بلداً واحداً فقط. اضبط exitClass على premium، لأن أياً من هذه الخيارات يرسل request عبر مخارج premium فقط. يحتفظ معرف proxy في الإجابة بالموقع، لذا فإن نقله إلى Single أو Browser هو كل ما يحتاجه هذان الوضعان. راجع موقع الخروج.

إعادة ضبط شريط الأدوات

يعمل زر Reset في شريط الأدوات (بجوار History و Saved) على مسح بيئة الاختبار وإعادتها إلى الحالة الأولية. ونظراً لكونه إجراءً هداماً، فإنه يفتح نافذة تأكيد تسرد بدقة ما سيتم مسحه: كل علامة تبويب request، وأي cookies محفوظة في الوعاء، وأي أجهزة proxy منقولة، والـ response الحالي. يتم الاحتفاظ بالإعدادات المسبقة المحفوظة ومفتاح API المحدد. انقر فوق Reset everything للتأكيد؛ وأي إجراء آخر يلغي العملية.

الإرسال والإلغاء

انقر فوق Send لإرسال request. ينتقل العمود الأيمن إلى حالة التحميل مع مؤشر دوار وزر Cancel أثناء معالجة الاستدعاء. انقر فوق Cancel (أو اضغط على الزر مرة أخرى على الهاتف المحمول) للإلغاء. يؤدي request الملغى إلى استعادة العنصر النائب في حالة الخمول مع عبارة "Request canceled." بدلاً من عرض خطأ.

تنتقل بطاقة response إلى النتيجة فور اكتمال request (أو فشله). على الهاتف، أو في أي نافذة ضيقة بما يكفي لوضع response أسفل النموذج، تقوم الصفحة بنقل بطاقة response إلى مجال الرؤية عندما تصل إلى جزء منخفض من الشاشة. قد تستغرق عمليات التشغيل التلقائي وقتاً أطول من المحركات اليدوية لأن آلية التدرج قد تصعد عدة درجات عند التعامل مع هدف جديد.

قراءة الـ Response

يعكس عمود response تخطيط request بعلامات التبويب الخاصة به:

علامة التبويب ما تعرضه
Body نص الاستجابة بعد تحليله. ينتقل بين عروض JSON وHTML وText وفقا لما تم استلامه.
Headers رؤوس الاستجابة، رأس واحد في كل سطر.
Cookies ملفات تعريف الارتباط التي أرجعها الهدف، في كل من العرض المحلل (مجمعة حسب المضيف) والعرض الخام (نص Set-Cookie). يعرض العرض المحلل شارة HO على ملفات تعريف الارتباط الخاصة بالمضيف فقط؛ ملفات تعريف ارتباط النطاق غير مميزة.
Raw غلاف JSON الكامل الذي تم إرجاعه بواسطة API.

يحتوي شريط أدوات الاستجابة على Copy وDownload للاستجابة بأكملها، وFind in response (Ctrl+K أو Cmd+K) للبحث في علامة التبويب المفتوحة، مع Enter وShift+Enter للتنقل بين النتائج. كما تحتوي Body وHeaders وCookies على خياري Copy وDownload خاصين بكل علامة تبويب منها.

يعرض شريط البيانات الوصفية أعلى علامات التبويب حالة HTTP الصادرة من الخادم الأصلي، والوقت الإجمالي، ومعرف proxy الذي تعامل مع الاستدعاء، و(لاستدعاء Proxy محدد النطاق) رمز exit <CODE> المكون من حرفين. يعرض الشريط أيضا حجم الاستجابة، ورصيد credits الذي استهلكه الطلب عند إبلاغ API عنه. بالنسبة لعمليات تشغيل Auto، تظهر الدرجة والمحاولات في الجملة الموجودة أسفل الشريط.

ما تطلبه الاستدعاء

توضح جملة أسفل شريط البيانات الوصفية آلية تنفيذ الصفحة نصيا. بالنسبة لعملية تشغيل Auto، تذكر الدرجة (جلسة كانت لدى FourA بالفعل للمضيف، أو طلب عادي، أو rotating proxy، أو متصفح حقيقي، أو متصفح أولا ثم إعادة تشغيل منخفضة التكلفة)، وما إذا كان قد تم حل تحدي أمني، وعدد المحاولات المستغرقة، والتكلفة. عندما يحدد الطلب exitClass، توضح أيضا ما إذا كان قد تم التسليم عبر مخرج premium أو من المجموعة القياسية.

عندما يرفض أحد حدود خطتك الاستدعاء، تذكر الجملة ذلك أولا: "تم الإيقاف بواسطة خطتك، وليس بواسطة الموقع"، متبوعا بالحد المعني (استنفاد طلبات المتصفح لهذا اليوم، عدد كبير جدا من الطلبات قيد المعالجة، استنفاد رصيد credits لهذه الفترة، وما إلى ذلك) ورابط إلى Usage & Limits. يتم إنشاء هذا السطر من رمز X-FourA-Limit الذي أرجعته API، لذا فإن الصفحة الصعبة التي تفشل توضح لك ما إذا كان الموقع هو الذي أوقفها أم الخطة.

نقل القيم بين عمليات التشغيل

بعد أي عملية تشغيل ترجع بيانات جلسة قابلة لإعادة الاستخدام، تظهر أداة تحكم صغيرة بعنوان Carry على شريط أدوات الاستجابة توضح ما هو متاح:

  • عمليات تشغيل Auto التي تتم باستخدام returnSession توفر userAgent وproxy الخاصين بالجلسة. تظهر ملفات تعريف الارتباط الخاصة بالجلسة في علامة التبويب Cookies للاستجابة، وتنتقل إلى حاوية ملفات تعريف الارتباط عند تفعيل Save response cookies.
  • توفر عمليات تشغيل Browser قيمة userAgent للاستجابة، بالإضافة إلى معرف proxy إذا تم استخدام أحدها.
  • توفر عمليات تشغيل Proxy معرف proxy المرتجع، وملف تعريف المتصفح عندما يختار التدوير ملفا لم تطلبه.

انقر على Carry واختر مكان تطبيق كل قيمة بنقرة واحدة: تصبح userAgent رأس User-Agent في Single أو Proxy، ويسقط معرف proxy في حقل proxy في Single أو Browser. الحقول التي تتلقى قيمة منقولة تعرض النقطة الحمراء "تم التعديل" حتى تتمكن من معرفة ما تغير.

يملأ ملف تعريف المتصفح (browser profile) المنقول حقول الاختيار الثلاثة لنظام التشغيل، والمتصفح، والإصدار، ويقوم بتفعيل unblocker، وهي نفس القاعدة المطبقة عند اختيار ملف تعريف يدويًا. لا يُتاح هذا الخيار إلا بعد تحميل دليل ملفات التعريف، نظرًا لأن النموذج يتكون من ثلاثة حقول اختيار وليس حقل معرف (id).

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

التوسيع إلى ملء الشاشة

تنقل أيقونة التوسيع الموجودة في شريط أدوات الاستجابة بطاقة الاستجابة من التخطيط المقسم إلى طبقة تراكب تملأ الشاشة بالكامل. استخدمها لتصفح أشجار JSON العميقة، أو سجلات Set-Cookie الطويلة، أو نصوص HTML العريضة التي تصبح ضيقة في العمود بنصف العرض. تتوقف الصفحة نفسها عن التمرير أثناء فتح طبقة التراكب. انقر فوق الأيقونة مرة أخرى (أو اضغط على مفتاح الهروب Escape) للطي.

أداة إعادة إنتاج curl

في علامة التبويب Raw للطلب، وأسفل كود JSON، يعرض كود curl المكافئ الدقيق لسطر الأوامر للطلب الذي تقوم ببنائه، مع زر Copy curl. انسخه لإعادة إنتاج الطلب من سطر الأوامر (terminal)، أو لمشاركته مع أحد أعضاء الفريق، أو للصقه في تقرير عن خطأ برمجي.

بالنسبة للمفاتيح القابلة للإظهار، يُدرج زر Reveal key المجاور للمقتطف المفتاح الحقيقي كنص عادي مباشرة في أمر curl، لتتمكن من النسخ والتشغيل كما هو. انقر مرة أخرى للإخفاء. المفاتيح القديمة (التي تم إنشاؤها قبل إطلاق ميزة الإظهار) تحتفظ بالعنصر النائب PASTE_PLAINTEXT_FOR_<key-name>؛ أعد إنشاء المفتاح من صفحة API Keys لجعله قابلاً للإظهار.

يتم تسجيل عملية الإظهار في سجل التدقيق (audit log) على الخادم في كل مرة، ولا يظل المفتاح بالنص العادي سوى في الذاكرة لجلسة الصفحة الحالية فقط.

حفظ الإعدادات المسبقة

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

افتح Saved في شريط الأدوات لعرض إعداداتك المسبقة. انقر فوق Load لملء النموذج، أو Delete لإزالة أحدها.

يتم تحميل الطلب المفتوح من علامة تبويب DevTools لإضافة FourA Chrome مع تحديد مفتاح الإضافة عندما يكون هذا المفتاح ضمن حسابك، وتوضح الصفحة ذلك. بخلاف ذلك، تطلب منك اختيار مفتاح. الطلب المعاد تشغيله والذي لا يحدد unblocker يعمل مع تفعيله، تمامًا كما تعمل API.

حقل الإعداد المسبق ما يخزنه
Name تسمية قصيرة (حتى 100 حرف)
Description ملاحظات اختيارية (حتى 500 حرف)
Endpoint المحرك المخصص له الإعداد المسبق (auto / single / proxy / browser)
Config حمولة الطلب الكاملة، بما يشمل حقول واجهة المستخدم، و headers، و cookies، و body

تقتصر الإعدادات المسبقة على نطاق حساب المستخدم الخاص بك ولا تتم مشاركتها مع أعضاء الفريق.

إعادة التشغيل من السجل

يتم تسجيل كل طلب تقوم بتشغيله. افتح History في شريط الأدوات لعرض آخر 20 عملية تشغيل، مرتبة من الأحدث إلى الأقدم.

يعرض كل صف الـ endpoint، وURL الهدف، والحالة، والوقت. انقر على Replay في أي صف لتحميل ذلك الـ request مرة أخرى في النموذج، ثم Send لتشغيله مجدداً.

يتم تحديد نطاق السجل تلقائياً لحسابك: لن ترى سوى عمليات التشغيل الخاصة بك فقط.

الفتح من النشاط

يحتوي مربع حوار تفاصيل سجل النشاط على زر Open in Playground. انقر فوقه وسيتم تحميل Playground مع كل من الـ request المؤرشف والـ response المؤرشف. يملأ النموذج البيانات من الـ payload المخزن، وتُظهر بطاقة الـ response ما أرجعته الـ API في تلك اللحظة مع شارة "archived" على شريط بيانات الـ proxy الوصفية ("archived

من هناك يمكنك تغيير أحد المعلمات والضغط على Send لتشغيل request جديد مقابل الـ API المباشرة، أو مجرد فحص الـ payload المؤرشف دون إعادة تشغيله. يتم الاحتفاظ بحمولات البيانات لمدة 24 ساعة، لذلك لن تحتوي صفوف النشاط الأقدم على response قابلة لإعادة التحميل.

نصائح

  • ابدأ في Playground قبل كتابة الكود البرمجي لهدف جديد. مع تفعيل Auto، ستعرف في غضون ثوانٍ ما إذا كان مجرد fetch منخفض التكلفة كافياً أم أن الموقع يفرض حلاً عبر المتصفح.
  • بالنسبة للأهداف المقيدة جغرافياً بدولة معينة، شغّل استدعاء Proxy واحداً مع تعيين exitCountries، ثم انقل معرف الـ proxy المُرجع إلى استدعاء Browser حتى يتم تصيير الـ JavaScript عبر نفس نقطة الخروج.
  • احفظ إعداداً مسبقاً لكل هدف تقوم بجمعه بانتظام. إعادة تشغيل إعداد مسبق محفوظ تتطلب نقرة واحدة؛ أما إعادة بناء الـ request من الذاكرة فتستغرق وقتاً أطول.
  • استخدم علامة تبويب Cookies لتصحيح أخطاء الجمع المعتمد على الجلسات. يعرض عرض Set-Cookie الخام ما أرسله الهدف بالضبط.
  • عندما يرفضك هدف ما، جرب إدخالاً آخر في خيارات Browser profile قبل اللجوء إلى محرك أثقل. تبديل المتصفح المعروض مجاني، بينما تصيير المتصفح ليس كذلك.
  • تُحسب طلبات Playground على المفتاح الذي تختاره. استخدم مفتاحاً مخصصاً بحصة منخفضة للاستكشاف العادي إذا كنت تريد الحفاظ على نظافة استخدام الإنتاج.
آخر تحديث: 11 نوفمبر 2026