المسارات المقاسة واستجابات الدفع

تعمل مسارات البيانات الثمانية كلها حاليًا في وضع observe بقرار من المالك. يقرأ الجرد المولَّد أدناه أغلفة المعالجات الفعلية وتكوين نسخة التطبيق هذه. وهو يسرد الأسعار المعلنة؛ ولا يعني فوترة نشطة. يظهر GET وPOST على مسار مشترك معًا. يستخدم كل وصول إلى مسارات البيانات صلاحية read القائمة، بما في ذلك عند تفعيل الفوترة.

• X-Credits-Price يعلن عدد الـ Credits لكل استدعاء.
• X-Payment-Notice يوضّح observe_mode_no_charge أو enforcement_pending أو terms_required أو billing_unavailable.
• X-Credits-Charged وX-Credits-Remaining يصفان استدعاءً تم احتسابه.
• X-Credits-Refunded يبلّغ عن استرداد حيثما ينطبق.

عند عدم كفاية الرصيد في استدعاء بيانات مقاس، يحتوي الغلاف على x402Version: 1 وقائمة accepts بمخطط scheme هو ftsobest-prepaid-router. هذا غلاف اكتشاف لمسار الدفع المسبق لدينا، وليس تعليمة دفع من نوع exact. قيمة maxAmountRequired هي 0؛ اجلب عرض سعر حقيقيًا من نقطة نهاية الشحن. لا تدفع صفرًا ولا تستنتج مبلغًا من ذلك الحقل. يشير كائن extra إلى المسار ويحمل مرساه بالدولار الأمريكي. قد تتلقى جلسات المتصفح إضافةً إلى ذلك topupPage. الإنفاذ المجهول معلّق حاليًا ويجب ألا يُعرض على أنه احتساب نشط.

{
  "x402Version": 1,
  "error": "insufficient_credits",
  "code": "insufficient_credits",
  "accepts": [
    {
      "scheme": "ftsobest-prepaid-router",
      "network": "flare",
      "maxAmountRequired": "0",
      "extra": {
        "flow": "challenge -> token -> topup(authorization, asset optional) -> router.pay(tx) -> confirm(txHash) -> retry with Bearer"
      }
    }
  ]
}

هذا غلاف مختصر، وليس مخططًا كاملًا. أما إخفاقات سعة الاشتراك فتستخدم بدلًا من ذلك code بقيمة slot_required أو insufficient_credits مع معلومات purchase وbuyEndpoint/topupEndpoint؛ ولا تَعِد بغلاف accepts نفسه.

curl -i 'https://ftso.app/api/ftso/analytics/overview?chain=flare' \
  -H 'authorization: Bearer fbx_READ_TOKEN'

راجع مرجع العمليات لواجهات الإدارة وعمليات الشحن لتمويل الرصيد.

• GET /api/ftso/analytics/board — ftso-analytics: 1 Credits لكل استدعاء; Scope: read; الوضع: observe.
• GET /api/ftso/analytics/movers — ftso-analytics: 1 Credits لكل استدعاء; Scope: read; الوضع: observe.
• GET /api/ftso/analytics/overview — ftso-analytics: 1 Credits لكل استدعاء; Scope: read; الوضع: observe.
• GET /api/ftso/analytics/volatility — ftso-analytics: 1 Credits لكل استدعاء; Scope: read; الوضع: observe.
• GET /api/intelligence/trust-radar — trust-radar: 5 Credits لكل استدعاء; Scope: read; الوضع: observe.
• GET/POST /api/providers/{chain}/rewards — providers-rewards: 2 Credits لكل استدعاء; Scope: read; الوضع: observe.
• GET /api/rewards-intelligence/external-rewards/scan — rewards-intelligence-scan: 10 Credits لكل استدعاء; Scope: read; الوضع: observe.
• GET /api/rewards-intelligence/reports — rewards-intelligence-reports: 10 Credits لكل استدعاء; Scope: read; الوضع: observe.