أبرز النقاط
أصبح استدعاء Auto الواحد يمثل الآن request واحداً في Dashboard الخاص بك. محاولات Single وProxy Finder وBrowser الكامنة خلفه لا تزال موجودة ومدرجة بالاسم أسفل الاستدعاء، ولكن معدل النجاح وlatency يُقاسان بناءً على ما طلبته. توقف احتساب الرفض الناتج عن خطتك الخاصة كحركة مرور (traffic)، وأصبح Auto يصنفه كـ rate limit، كما تعرض صفحة Billing كل عملية شحن رصيد في سطر مستقل.
ما الجديد
احتساب استدعاءات Auto كـ request واحد
كان استدعاء Auto يظهر سابقاً في Dashboard على شكل المحاولات التي قام بها، لذلك كان الرابط الواحد قد يبدو كعدة requests، وبعضها فاشل. الآن تعرض صفحات Overview وUsage & Limits وActivity خدمة Auto كمنتج مستقل. كل استدعاء هو صف واحد بنتيجة نهائية واحدة، ويحمل credits وbytes الخاصة بمحاولاته، والتي تظهر تحته بالاسم. يستمر rate limit الخاص بك في احتساب المحاولات، لأنها تمثل requests التي تنفذها المحركات فعلياً.
افتح Activity بعد الاستدعاء مباشرة وسيظهر الصف أن محاولاته لا تزال قيد المعالجة. بعد ثوانٍ قليلة، تكتمل قائمة المحاولات مع credits وbytes في مكانها دون الحاجة لإعادة تحميل الصفحة، بحيث لا يتغير موضع الصف الذي تتابعه.
يتطابق هذا مع طريقة الاستخدام المستهدفة لـ Auto. إنه أداة لاكتشاف المسار: دعه يحدد المستوى الناجح، ثم أعد إرسال session الذي يرجعه عبر /api/single أو /api/browser ووجّه حجم طلباتك إلى هناك. تعرض لك صفحة Activity الآن ما حاول كل استدعاء تنفيذه قبل أن تعتمد مساراً محدداً.
رفض الخطة: لا يُحتسب كحركة مرور، ومصنف في Auto أيضاً
الـ request المرفوض بسبب تجاوز حد في خطتك لم يعد يُضاف إلى إجمالي traffic الخاص بك. لم يتم جلب أي شيء، وبالتالي لا يتم احتساب أي شيء. يظل رمز 403 أو 500 الوارد من الموقع محتسباً، لأننا نقلنا تلك الاستجابة إليك.
عندما يواجه استدعاء Auto أحد هذه الحدود، تعرضه صفحة Activity كـ Rate Limited بدلاً من اعتباره فشلاً، وتحمل الاستجابة نفس header الـ X-FourA-Limit الذي يعيده الاستدعاء المباشر:
import requests
r = requests.post(
"https://api.foura.ai/api/auto",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data"},
)
limit = r.headers.get("X-FourA-Limit")
if limit:
print("stopped by my plan:", limit)
else:
session = r.json().get("session") # replay on /api/single or /api/browser
توضح إجابة إضافية الآن ما حدث بالفعل. الهدف الذي لا يمكن حل اسم المضيف الخاص به يعود من Single و Browser و Proxy Finder و Auto بنفس الطريقة التي يعود بها أي موقع لا يمكن الوصول إليه: status 0، وخطأ يحدد المضيف، ونتيجة الهدف (application_fail، راجع outcomes). تظل أهداف الشبكة الخاصة تتلقى رفض 400.
حركة المرور، بوحدة واحدة
نحدد الآن بوضوح ما يعنيه الجيجابايت: 1,073,741,824 بايت، في كل حصة وعداد. تُحسب حركة مرور API على الصفحة بعد فك ترميزها، لأن تلك الصفحة هي ما نقدمه لك، سواء استلزم الأمر متصفحا حقيقيا أو خطوة إضافية طلبتها الصفحة. تُحسب حركة مرور منفذ Proxy أثناء عبورها النفق، حيث ننقل اتصالك دون المساس بأي محتوى بداخله. تعرض لوحة التحكم الخاصة بك التعريف بجوار أرقام حركة المرور، ويحتوي How Your Plan Is Metered على المنهجية الكاملة.
تُقرأ أرقام حركة المرور بالجيجابايت أينما وجد حد بالجيجابايت بجانبها، بحيث تتم مقارنة الرقم بسقفه مباشرة. تمت إضافة لوحة Traffic إلى صفحة Limits (الإجمالي، و API، ومنفذ Proxy، و Premium، مع شريط لكل منها حيث تحدد خطتك سقفا)، وأضاف جدول مفاتيح API عمودي Traffic و Premium، وتُظهر كل لوحة منتج في Overview حركة المرور الخاصة بها.
والحد الذي وصلت إليه يظهر الآن باللون الأحمر At limit، نظرا لأن الطلب التالي سيتم رفضه. يُظهر حد العدد عند سقفه، مثل مفاتيح API، باللون البرتقالي: فهو يمنع فقط الإضافة التالية.
الفوترة: أربع بطاقات وسطر لكل عملية شحن
تعرض Billing page البطاقات الأربع نفسها في كل خطة: الرصيد أو حركة المرور القياسية أولا (أيهما تباع به خطتك)، ثم الرقم الآخر، و Premium، ومنفذ Proxy. تحتوي كل بطاقة على زر Buy. عندما لا تبيع خطتك هذا العنصر، يوضح الزر ذلك ويوفر طريقة للتواصل معنا.
في الخطة المدفوعة التي تباع بالرصيد، يتضمن منفذ Proxy جيجابايت خاصة به، ويمكنك شراء المزيد من بطاقته. تحصل كل عملية شحن على سطر خاص بها يوضح ما اشتريته، وما تم استخدامه، وما تبقى. يُخصم الاستخدام من عملية الشحن التي تنتهي صلاحيتها أولا.
تقدم رسائل البريد الإلكتروني الخاصة بالاستخدام تفاصيل أكثر أيضا. عند 95% تتلقى إشعارا باليوم الذي ستنفد فيه حصتك وفق وتيرة هذه الفترة، مقارنة بتاريخ إعادة التعيين، بالإضافة إلى الإجراء الوحيد لزيادتها. يوضح بريد 100% عدد الأيام المتبقية حتى إعادة التعيين، وتكلفة الفوترة للباقي في الخطط التي تتضمن تجاوزا للحد.
MCP 0.7.3
ينشر FourA MCP 0.7.3 مخططات أدوات يتم التحقق منها وفق كل من JSON Schema draft-07 و 2020-12، بحيث يمكن لأي عميل مزود بمدقق 2020-12 صارم سرد جميع الأدوات الأربع واستدعاؤها. لم يتغير ما يقبله الاستدعاء. قم بتحديث @fouradata/mcp، أو استخدم الخادم المستضاف، الذي يعمل بالفعل بالإصدار 0.7.3.
التوثيق والموقع
- اختر نتيجة في بحث docs وستنتقل الصفحة مباشرة إلى أول موضع تظهر فيه كلمتك مع تمييزها. يتم تحديد النتيجة الأولى بمجرد ظهور النتائج، لذا يؤدي الضغط على Enter إلى فتحها مباشرة.
- على الهواتف والأجهزة اللوحية، تفتح قائمة الموقع الرئيسي بمجرد رفع إصبعك وتملأ الشاشة في عمودين، كما تُعرض كل صفحة بتنسيقها الكامل من الإطار الأول.
التفاصيل التقنية الداخلية
تبدأ سعة Proxy Finder الجديدة الآن بالاستفادة مما تعلمته السعة الحالية بالفعل عن كل مضيف. وبذلك تظل أوقات الاستجابة مستقرة أثناء انضمامها، بدلا من أن تستغرق دقائق أولى للاستقرار مع حركة المرور الخاصة بك.
يجب أن يقودك أي رقم في Dashboard إلى إجراء قامت به مهمتك. إذا كان تحديد مصدره يتطلب آلة حاسبة ومستنداتنا، فإن مهمتنا هي تصحيح الرقم، وليست مهمتك فك رموزه.