Routes mesurées et réponses de paiement

Les huit routes de données fonctionnent actuellement en observe par décision du propriétaire. L’inventaire généré ci-dessous lit les wrappers de handlers réels et la configuration de cette instance d’application. Il liste les prix annoncés ; il n’implique pas une facturation active. GET et POST sur un chemin partagé apparaissent ensemble. Tout accès aux routes de données utilise la permission read existante, y compris lorsque la facturation est activée.

• X-Credits-Price annonce les crédits par appel.
• X-Payment-Notice explique observe_mode_no_charge, enforcement_pending, terms_required ou billing_unavailable.
• X-Credits-Charged et X-Credits-Remaining décrivent un appel facturé.
• X-Credits-Refunded signale un remboursement le cas échéant.

En cas de crédits insuffisants sur un appel de données mesuré, l’enveloppe contient x402Version: 1 et une liste accepts avec le scheme ftsobest-prepaid-router. C’est une enveloppe de découverte pour notre flux prépayé, pas une instruction de paiement exact. maxAmountRequired vaut 0 ; obtenez un vrai devis auprès de l’endpoint de rechargement. Ne payez pas zéro et ne déduisez pas de montant de ce champ. L’objet extra renvoie vers le flux et porte son ancrage USD. Les sessions navigateur peuvent recevoir en plus topupPage. L’enforcement anonyme est actuellement en attente et ne doit pas être présenté comme une facturation active.

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

Ceci est une enveloppe abrégée, pas un schéma complet. Les échecs de capacité d’abonnement utilisent à la place le code slot_required ou insufficient_credits avec des informations purchase et buyEndpoint/topupEndpoint ; ils ne promettent pas la même enveloppe accepts.

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

Voir la référence des opérations pour les API de gestion et les rechargements pour alimenter le solde.

• GET /api/ftso/analytics/board — ftso-analytics: 1 crédits par appel; Scope: read; mode: observe.
• GET /api/ftso/analytics/movers — ftso-analytics: 1 crédits par appel; Scope: read; mode: observe.
• GET /api/ftso/analytics/overview — ftso-analytics: 1 crédits par appel; Scope: read; mode: observe.
• GET /api/ftso/analytics/volatility — ftso-analytics: 1 crédits par appel; Scope: read; mode: observe.
• GET /api/intelligence/trust-radar — trust-radar: 5 crédits par appel; Scope: read; mode: observe.
• GET/POST /api/providers/{chain}/rewards — providers-rewards: 2 crédits par appel; Scope: read; mode: observe.
• GET /api/rewards-intelligence/external-rewards/scan — rewards-intelligence-scan: 10 crédits par appel; Scope: read; mode: observe.
• GET /api/rewards-intelligence/reports — rewards-intelligence-reports: 10 crédits par appel; Scope: read; mode: observe.