نظرة عامة

فوترة مسبقة الدفع بالـ Credits وأتمتة للمطوّرين والآلات.

آخر تحديث: 30‏/09‏/2026

تسمّي FTSOBest هذه الواجهة "x402 v1": ‏x402Version: 1 والمخطط الخاص ftsobest-prepaid-router. هي ليست بروتوكول x402 V2 بمخطط exact ‏(Coinbase/x402.org). لا يستطيع عميل x402 قياسي أن يدفع هنا عبر مسار الدفع القياسي الخاص به. استخدم مسار SIWE وBearer-Token والشحن المسبق الموصوف في هذه الوحدة.

ما الذي تتم فوترته؟

عملية شحن على السلسلة (on-chain) تشتري Credits مثبّتة بالدولار الأمريكي. الاستخدام المقاس يُقيَّد خارج السلسلة (off-chain) على رصيد محفظة واحد؛ لا توجد معاملة gas لكل استدعاء API. اشتراكات Watchdog تشتري سعة Slot. إنشاء watch ضمن السعة المتاحة لا يؤدي إلى عملية شراء أخرى.

مسارات البيانات الثمانية المقاسة تعمل حاليًا في وضع observe بقرار من المالك ولا تحتسب شيئًا. الأسعار تُعلن ولا تُحصَّل. Watchdog هو المنتج المدفوع. وظائف المحفظة الأساسية تبقى مجانية. راجع مسارات البيانات والترويسات وCredits.

الاتصال بالواجهة

أصل الواجهة (origin) يأتي من تكوين الخادم نفسه المستخدم لـ SIWE وOpenAPI والاكتشاف. الإنتاج يستخدم ftso.app؛ استخدم الأصل الذي يعلنه الخادم بدلًا من أصل موقع SEO.

API_BASE='https://ftso.app'
curl "$API_BASE/api/x402/pricing?locale=en"

وضعا observe وenforce

يعلن observe الأسعار دون احتساب. يطبّق enforce الفحوص القائمة للمصادقة والشروط والحصة المجانية والـ Credits. قد يترك تعطّل تبعية الفوترة استجابة البيانات متاحة مع X-Payment-Notice: billing_unavailable. تعامل مع هذا التنبيه بشكل منفصل عن خطأ المصادقة أو الصلاحية؛ أمان مسارات الإدارة لا يفشل بشكل مفتوح. تغييرات الوضع قرارات للمشغّل، وليست إجراءات يمكن للعميل طلبها.

واجهة Watchdog والاكتشاف

الرابط السابق /x402/docs#watchdog يصل إلى هنا. تابع إلى Watchdog API. إرشادات الإعداد للمستخدمين تبقى في توثيق Watchdog.