أبرز التحديثات
الطلب الذي يحتوي على خطأ من جانبك أصبح يرجع رمز 400 بدلاً من 503 من جانبنا. تحدد أدوات Single وProxy Finder وBrowser كل حقل به خطأ، دون احتساب أي تكلفة عليه، ودون التسبب في محاولة إعادة إرسال لن تنجح. كما تفصل واجهة Budget الآن بين الرصيد الذي تدفعه وكل ما استهلكته طلباتك، ويؤدي تغيير كلمة المرور الآن إلى تسجيل الخروج من جميع جلسات Dashboard الأخرى. ستجد أول نقطتين في سجل التغييرات.
ما الجديد
الطلب غير الصالح يوضح سبب الخطأ
إذا أرسلت إلى Single أو Proxy Finder أو Browser نص طلب لا يمكن تنفيذه (مثل نقص url، أو إرسال timeout_ms بقيمة ليست رقماً)، فستتلقى رمز الحالة HTTP 400. تبدأ استجابة error بـ Invalid request: وتوضح كل حقل يحتوي على خطأ مع السبب، حتى خمسة أخطاء. وتعتبر هذه النتيجة client_error وتكلفتها 0 من الرصيد.
حتى هذا الأسبوع، كانت تلك الطلبات ترجع رمز 503 عاماً، وهو ما يشير إلى وجود مشكلة من جانبنا ويدفع حلقة إعادة المحاولة إلى تكرار الإرسال. إذا كان العميل البرمجي لديك يعامل رمز 400 كنتيجة نهائية (كما في المثال الموضح في مرجع الأخطاء لدينا)، فإن الخطأ المطبعي سيوقف التنفيذ الآن من الطلب الأول:
import requests
r = requests.post(
"https://api.foura.ai/api/single",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data", "timeout_ms": "fast"},
)
if r.status_code == 400:
# "Invalid request: timeout_ms: ..." means fix the call, don't retry it
raise ValueError(r.json()["error"])
يعمل Auto هنا كما في السابق. فالحقل الذي يتعذر قبوله يستمر في إرجاع رمز الحالة HTTP 200 مع status: 400 والسبب في error، قبل أي محاولة ودون أي تكلفة.
الأرصدة المفوترة والمستهلكة، جنبا إلى جنب
تبدأ شاشة Budget ضمن Metrics الآن بالأرصدة المفوترة (billed credits)، وهي الأرصدة التي تستهلكها فقط الطلبات الناجحة، وتُظهر كل ما تم استهلاكه مباشرة في الأسفل بصيغة "من أصل N مستهلك". وتظهر تكلفة كل طلب بالأرصدة المفوترة أيضا. كما يحتوي التفصيل حسب المفتاح أو النطاق أو عنوان IP الخاص بالعميل على عمود قابل للترتيب لكل رقم.
يحسب الرصيد المستهلك جميع النتائج، نظرا لأن الطلب الفاشل لا يزال يتطلب عقدة خروج أو متصفحا لاكتشاف فشله. بالتالي، توضح الفجوة بين العمودين، نطاقا بنطاق، حجم العمل والموارد المبذولة على طلبات لم تنجح.
تسجيل الخروج يعني إنهاء الجلسة تماما
عند تغيير كلمة المرور في Settings، أو إعادة تعيينها من صفحة تسجيل الدخول، أو النقر على Sign Out Others، يتم تسجيل الخروج من كل متصفح آخر مسجل الدخول إلى حسابك. ويبقى المتصفح الذي أجريت التغيير منه قيد تسجيل الدخول. كما يؤدي تسجيل الخروج الآن إلى إنهاء تلك الجلسة من جهتنا أيضا، وليس فقط داخل متصفحك.
تطلب صفحة إعادة تعيين كلمة المرور الآن نفس خطوة التحقق المستخدمة في تسجيل الدخول وإنشاء الحساب. وتظل محجوبة عن الأنظار ما لم تكن هناك حاجة لتدخلك.
أداة Proxy Finder وإعادة توجيه البوابات
تقع بعض عقد الخروج خلف بوابة شبكة تابعة للشركة. وقد غطى الموجز السابق النوع الذي يستجيب بصفحة تسجيل دخول خاصة به. وترصد أداة Proxy Finder الآن أيضا النوع الذي يستجيب بإعادة توجيه إلى خدمة تسجيل الدخول الخاصة به، حيث تعتبره محاولة فاشلة وتنتقل إلى عقدة خروج أخرى، بدلا من إرجاع إعادة التوجيه تلك كاستجابة من الموقع المستهدف.
إصلاحات طفيفة في Dashboard
- عندما لا يملك المالك المحدد (Everything أو Personal أو إحدى المؤسسات) أي مفاتيح API بعد، توضح صفحتا Overview وMetrics ذلك تحت الفترة الزمنية وتوجهك لإنشاء مفتاح.
- يظهر كل رقم في صفحة Overview مباشرة أسفل تسميته بحجم موحد، مما يجعل قراءة صف اللوحات متناسقة بأي عرض للشاشة. تظهر لوحة محاولات Auto دائما، وتُظهر صفرا لأي فترة تخلو من استدعاءات Auto.
- تُخفي صفحة Subscribe مفتاح التبديل بين Monthly/Annual لأي خطة تُباع بخيار واحد فقط.
- في الفترات التجريبية التي ننشئها لك، يؤدي اختيار خطة مختلفة في صفحة الترقية الآن إلى طلب بطاقة دفع وبدء فترة كاملة في ذلك اليوم. وتنتهي الفترة التجريبية فور إتمام عملية الدفع بنجاح.
تحت غطاء المحرك
تتم الاستجابة للاستدعاءات الموجهة إلى api.foura.ai وeu.api.foura.ai الآن بواسطة عدة خوادم في وقت واحد بدلا من خادم واحد. وإذا توقف أحدها عن الاستجابة، يتم توجيه الاستدعاءات الجديدة إلى الخوادم الأخرى في غضون دقيقتين.
أصبح Auto أخف وزنا. فاختيار جلسة محفوظة لأحد الاستدعاءات يتطلب أربع عمليات بحث داخلية فقط بدلا من العشرات، ويعمل كل خادم بسعة استيعابية أكبر لـ Auto مقارنة بالسابق، مما يقلل الوقت الذي تقضيه استدعاءات Auto في قوائم الانتظار خلال ساعات الذروة.
انتقل كل محرك إلى بيئة التشغيل الحالية ذات الدعم طويل الأمد (LTS) مع إصدار الأمان لشهر أكتوبر، وقمنا بتحديث المكتبات عبر الـ API، ولوحة التحكم (Dashboard)، والتوثيق، والمدونة. في Single وProxy Finder، تحافظ بيئة التشغيل الجديدة على مخرج واحد يمنع أي توقف عن القراءة أثناء الـ request من إبطاء الـ requests الأخرى على الخادم نفسه. قبل إعادة تشغيل الخادم لإصدار جديد، يتوقف عن استقبال المكالمات الجديدة، ويعود للخدمة فور تجاوزه للفحوصات.
تنتمي محاولات إعادة الإرسال (retries) إلى المواقع التي تجبرك على الانتظار، وليس إلى خطأ مطبعي في الـ request الخاص بك.