मापे गए रूट और भुगतान प्रतिक्रियाएँ

संसाधन कीमतें, बिलिंग मोड और स्वयं का 402 envelope।

अंतिम अपडेट: 30 सित॰ 2026

वर्तमान बिलिंग स्थिति

सभी आठ डेटा रूट वर्तमान में Owner के निर्णय से observe में चलते हैं। नीचे दी गई जनरेट की गई सूची वास्तविक handler wrappers और इस एप्लिकेशन इंस्टेंस की कॉन्फ़िगरेशन को पढ़ती है। यह दिखाई गई कीमतें सूचीबद्ध करती है; इसका अर्थ सक्रिय बिलिंग नहीं है। साझा पथ पर GET और POST एक साथ दिखते हैं। सभी डेटा-रूट एक्सेस मौजूदा read अनुमति का उपयोग करते हैं, बिलिंग सक्षम होने पर भी।

प्रतिक्रिया हेडर

  • X-Credits-Price प्रति कॉल क्रेडिट दिखाता है।
  • X-Payment-Notice observe_mode_no_charge, enforcement_pending, terms_required या billing_unavailable समझाता है।
  • X-Credits-Charged और X-Credits-Remaining एक चार्ज की गई कॉल का वर्णन करते हैं।
  • X-Credits-Refunded लागू होने पर रिफंड की रिपोर्ट करता है।

402 प्रतिक्रिया

मापी गई डेटा कॉल पर अपर्याप्त क्रेडिट होने पर envelope में x402Version: 1 और scheme ftsobest-prepaid-router वाली accepts सूची होती है। यह हमारे प्रीपेड प्रवाह के लिए एक Discovery envelope है, exact भुगतान निर्देश नहीं। maxAmountRequired 0 है; वास्तविक quote टॉपअप एंडपॉइंट से लें। शून्य का भुगतान न करें और उस फ़ील्ड से कोई राशि न निकालें। extra ऑब्जेक्ट प्रवाह से लिंक करता है और उसका USD anchor रखता है। ब्राउज़र सेशन को अतिरिक्त रूप से topupPage मिल सकता है। Anonymous enforcement वर्तमान में लंबित है और इसे सक्रिय चार्जिंग के रूप में प्रस्तुत नहीं किया जाना चाहिए।

{
  "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"
      }
    }
  ]
}

यह एक संक्षिप्त envelope है, पूर्ण स्कीमा नहीं। सब्सक्रिप्शन क्षमता की विफलताएँ इसके बजाय code slot_required या insufficient_credits का उपयोग purchase और buyEndpoint/topupEndpoint जानकारी के साथ करती हैं; वे उसी accepts envelope का वादा नहीं करतीं।

डेटा रूट पढ़ें

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

प्रबंधन APIs के लिए ऑपरेशन संदर्भ और बैलेंस भरने के लिए टॉपअप देखें।

मापे गए डेटा रूट

  • GET /api/ftso/analytics/board — ftso-analytics: 1 क्रेडिट प्रति कॉल; Scope: read; मोड: observe.
  • GET /api/ftso/analytics/movers — ftso-analytics: 1 क्रेडिट प्रति कॉल; Scope: read; मोड: observe.
  • GET /api/ftso/analytics/overview — ftso-analytics: 1 क्रेडिट प्रति कॉल; Scope: read; मोड: observe.
  • GET /api/ftso/analytics/volatility — ftso-analytics: 1 क्रेडिट प्रति कॉल; Scope: read; मोड: observe.
  • GET /api/intelligence/trust-radar — trust-radar: 5 क्रेडिट प्रति कॉल; Scope: read; मोड: observe.
  • GET/POST /api/providers/{chain}/rewards — providers-rewards: 2 क्रेडिट प्रति कॉल; Scope: read; मोड: observe.
  • GET /api/rewards-intelligence/external-rewards/scan — rewards-intelligence-scan: 10 क्रेडिट प्रति कॉल; Scope: read; मोड: observe.
  • GET /api/rewards-intelligence/reports — rewards-intelligence-reports: 10 क्रेडिट प्रति कॉल; Scope: read; मोड: observe.