Référence de l’API machine

• OpenAPI 3.1
• llms.txt
• Catalogue d’API RFC 9727
• Schéma du payload de Webhook v2
• Tarifs et catalogue en direct

La liste des opérations est générée à partir du même registre qu’OpenAPI, et non copiée de l’ancienne documentation. La méthode, le chemin, le Scope, le Scope conditionnel et la prise en charge de l’idempotence suivent le registre ; les explications proviennent d’un dictionnaire traduit indexé par operationId. Une opération non reconnue requiert une traduction dans chaque langue, au lieu d’afficher silencieusement de l’anglais.

OpenAPI utilise actuellement des objets de requête/réponse génériques pour de nombreuses opérations. Son exemple générique de requête wallet n’est pas un payload valide pour chaque POST. Utilisez les exemples vérifiés sur authentification, rechargements et Watchdog pour ces parcours. Le document est une référence de découverte, pas une affirmation que chaque route partage le même statut ou les mêmes champs de réponse.

Ce module couvre la facturation machine x402 et l’automatisation Watchdog. Les routes de données mesurées utilisent leurs API existantes et sont listées séparément. MCP est une interface d’outils en lecture seule avec un flux de compte OAuth distinct ; son implémentation n’est pas modifiée par ce module. Les guides utilisateur Crédits et MCP sont des tranches de documentation distinctes.

• GET /api/x402/account — Scope: read; Obtenir le solde de crédits et le ledger.
• GET /api/x402/account/terms — Scope: read; Obtenir l’acceptation des conditions.
• POST /api/x402/account/terms — Scope: write; Accepter les conditions actuelles.
• GET /api/x402/alerts — Scope: read; Lister l’historique des alertes.
• DELETE /api/x402/alerts — Scope: write; Supprimer l’historique d’alertes sélectionné.
• DELETE /api/x402/alerts/{id} — Scope: write; Supprimer une alerte.
• GET /api/x402/alerts/export — Scope: read; Exporter l’historique des alertes en CSV.
• POST /api/x402/auth/challenge — Scope: Aucune authentification; Créer un challenge SIWE avec Scopes.
• POST /api/x402/auth/token — Scope: Aucune authentification; Échanger un message SIWE signé contre un Bearer-Token.
• GET /api/x402/auth/tokens — Scope: read; Lister les tokens d’API du wallet.
• DELETE /api/x402/auth/tokens/{id} — Scope: write; Révoquer un token d’API.
• GET /api/x402/channels — Scope: read; Lister l’état des canaux.
• PUT /api/x402/channels/{key} — Scope: write; Configurer un canal de saisie; Idempotency-Key pris en charge.
• DELETE /api/x402/channels/{key} — Scope: write; Supprimer la cible d’un canal.
• POST /api/x402/channels/{key}/test — Scope: write; Envoyer un test de canal.
• POST /api/x402/message-preview — Scope: read; Prévisualiser un message localisé.
• GET /api/x402/openapi.json — Scope: Aucune authentification; Obtenir ce document OpenAPI.
• GET /api/x402/pricing — Scope: Aucune authentification; Découvrir les tarifs, produits, watches, signaux et l’aide.
• GET /api/x402/provider-fsp — Scope: read; Obtenir la vue FSP du fournisseur.
• GET /api/x402/recipients — Scope: read; Lister les destinataires nommés.
• POST /api/x402/recipients — Scope: write; Créer un destinataire de saisie; Idempotency-Key pris en charge.
• PATCH /api/x402/recipients/{id} — Scope: write; Mettre à jour un destinataire.
• DELETE /api/x402/recipients/{id} — Scope: write; Supprimer un destinataire.
• POST /api/x402/recipients/{id}/test — Scope: write; Tester un destinataire.
• POST /api/x402/recipients/telegram-link — Scope: write; Créer un lien de destinataire Telegram.
• GET /api/x402/settings — Scope: read; Obtenir les paramètres de notification.
• PUT /api/x402/settings — Scope: write; Remplacer les paramètres de notification.
• GET /api/x402/stats — Scope: Aucune authentification; Obtenir les agrégats publics de facturation.
• GET /api/x402/subscriptions — Scope: read; Lister les abonnements et la capacité.
• POST /api/x402/subscriptions — Scope: spend; Acheter de la capacité d’abonnement; Idempotency-Key pris en charge.
• PATCH /api/x402/subscriptions — Scope: write (spend lorsque autoRenew vaut true); Mettre à jour Auto-Renew.
• GET /api/x402/subscriptions/quote — Scope: read; Obtenir un devis de capacité d’abonnement.
• POST /api/x402/subscriptions/trial — Scope: write; Démarrer l’essai unique.
• POST /api/x402/topup — Scope: write; Créer un brouillon de rechargement; Idempotency-Key pris en charge.
• GET /api/x402/topup/{handle} — Scope: read; Obtenir le statut d’un rechargement.
• POST /api/x402/topup/{handle}/confirm — Scope: write; Confirmer une transaction de rechargement.
• GET /api/x402/watches — Scope: read; Lister les watches.
• POST /api/x402/watches — Scope: write; Créer une watch; Idempotency-Key pris en charge.
• GET /api/x402/watches/{id} — Scope: read; Obtenir une watch.
• PATCH /api/x402/watches/{id} — Scope: write; Mettre à jour une watch.
• DELETE /api/x402/watches/{id} — Scope: write; Supprimer une watch.