মিটার করা রুট এবং পেমেন্ট রেসপন্স

রিসোর্স মূল্য, বিলিং মোড এবং নিজস্ব 402 envelope।

সর্বশেষ আপডেট: ৩০ সেপ, ২০২৬

বর্তমান বিলিং অবস্থা

আটটি ডেটা রুটই বর্তমানে owner-এর সিদ্ধান্তে observe মোডে চলছে। নিচের generated inventory প্রকৃত handler wrapper এবং এই অ্যাপ্লিকেশন instance-এর কনফিগারেশন পড়ে। এটি ঘোষিত মূল্য তালিকাভুক্ত করে; সক্রিয় বিলিং বোঝায় না। একই path-এর GET এবং POST একসাথে দেখানো হয়। সব ডেটা-রুট অ্যাক্সেস বিদ্যমান read permission ব্যবহার করে, বিলিং সক্রিয় থাকলেও।

রেসপন্স header

  • 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 প্রযোজ্য ক্ষেত্রে refund জানায়।

402 রেসপন্স

মিটার করা ডেটা কলে credit অপর্যাপ্ত হলে envelope-এ x402Version: 1 এবং scheme ftsobest-prepaid-router সহ একটি accepts তালিকা থাকে। এটি আমাদের প্রিপেইড ফ্লোর একটি discovery envelope, কোনো exact পেমেন্ট নির্দেশ নয়। maxAmountRequired হলো 0; প্রকৃত quote টপআপ endpoint থেকে নিন। শূন্য পেমেন্ট করবেন না বা ওই field থেকে পরিমাণ অনুমান করবেন না। extra object ফ্লোর সাথে লিংক করে এবং এর USD anchor বহন করে। ব্রাউজার সেশন অতিরিক্তভাবে topupPage পেতে পারে। Anonymous enforcement বর্তমানে pending এবং এটিকে সক্রিয় চার্জিং হিসেবে উপস্থাপন করা যাবে না।

{
  "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, সম্পূর্ণ schema নয়। সাবস্ক্রিপশন ক্যাপাসিটি ব্যর্থতা এর বদলে 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'

ম্যানেজমেন্ট API-এর জন্য দেখুন অপারেশন রেফারেন্স এবং ব্যালেন্সে অর্থ যোগ করার জন্য টপআপ।

মিটার করা ডেটা রুট

  • 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.