Machine-API-Referenz

• OpenAPI 3.1
• llms.txt
• RFC-9727-API-Katalog
• Webhook-Payload-v2-Schema
• Aktuelle Preise und Katalog

Die Operationsliste wird aus demselben Register wie OpenAPI erzeugt statt aus der alten Dokumentation kopiert. Methode, Pfad, Scope, bedingter Scope und Idempotency-Unterstützung folgen dem Register; Erklärungen stammen aus einem übersetzten Wörterbuch mit operationId als Schlüssel. Eine unbekannte Operation benötigt eine Übersetzung, statt in einer Sprache unbemerkt Englisch anzuzeigen.

OpenAPI verwendet derzeit für viele Operationen generische Request-/Response-Objekte. Das generische Wallet-Request-Beispiel ist kein gültiger Payload für jeden POST. Nutze die geprüften Beispiele für Authentifizierung, Aufladungen und Watchdog für diese Abläufe. Das Dokument dient als Discovery-Referenz und behauptet nicht, dass alle Routen denselben Antwortstatus oder dieselben Felder verwenden.

Dieses Modul beschreibt x402-Maschinenabrechnung und Watchdog-Automatisierung. Die bemessenen Datenrouten nutzen ihre bestehenden APIs und werden separat aufgeführt. MCP ist eine nur lesende Tool-Schnittstelle mit einem eigenen OAuth-Kontoablauf; dieses Modul ändert ihre Implementierung nicht. Credits- und MCP-Nutzeranleitungen sind separate Doku-Slices.

• GET /api/x402/account — Scope: read; Guthaben und Ledger abrufen.
• GET /api/x402/account/terms — Scope: read; Zustimmung zu Nutzungsbedingungen abrufen.
• POST /api/x402/account/terms — Scope: write; Aktuellen Nutzungsbedingungen zustimmen.
• GET /api/x402/alerts — Scope: read; Alarm-Verlauf auflisten.
• DELETE /api/x402/alerts — Scope: write; Ausgewählten Alarm-Verlauf löschen.
• DELETE /api/x402/alerts/{id} — Scope: write; Einen Alarm löschen.
• GET /api/x402/alerts/export — Scope: read; Alarm-Verlauf als CSV exportieren.
• POST /api/x402/auth/challenge — Scope: Keine Authentifizierung; SIWE-Challenge mit Scopes erstellen.
• POST /api/x402/auth/token — Scope: Keine Authentifizierung; Signierte SIWE-Nachricht gegen Bearer-Token tauschen.
• GET /api/x402/auth/tokens — Scope: read; API-Token der Wallet auflisten.
• DELETE /api/x402/auth/tokens/{id} — Scope: write; API-Token widerrufen.
• GET /api/x402/channels — Scope: read; Kanalstatus auflisten.
• PUT /api/x402/channels/{key} — Scope: write; Eingabekanal konfigurieren; Idempotency-Key unterstützt.
• DELETE /api/x402/channels/{key} — Scope: write; Kanalziel entfernen.
• POST /api/x402/channels/{key}/test — Scope: write; Kanal testen.
• POST /api/x402/message-preview — Scope: read; Lokalisierte Nachricht vorschauen.
• GET /api/x402/openapi.json — Scope: Keine Authentifizierung; Dieses OpenAPI-Dokument abrufen.
• GET /api/x402/pricing — Scope: Keine Authentifizierung; Preise, Produkte, Watches, Signale und Hilfe entdecken.
• GET /api/x402/provider-fsp — Scope: read; Provider-FSP-Ansicht abrufen.
• GET /api/x402/recipients — Scope: read; Benannte Empfänger auflisten.
• POST /api/x402/recipients — Scope: write; Empfänger mit Eingabeziel erstellen; Idempotency-Key unterstützt.
• PATCH /api/x402/recipients/{id} — Scope: write; Empfänger aktualisieren.
• DELETE /api/x402/recipients/{id} — Scope: write; Empfänger löschen.
• POST /api/x402/recipients/{id}/test — Scope: write; Empfänger testen.
• POST /api/x402/recipients/telegram-link — Scope: write; Telegram-Verknüpfung für Empfänger erstellen.
• GET /api/x402/settings — Scope: read; Benachrichtigungseinstellungen abrufen.
• PUT /api/x402/settings — Scope: write; Benachrichtigungseinstellungen aktualisieren.
• GET /api/x402/stats — Scope: Keine Authentifizierung; Öffentliche Abrechnungskennzahlen abrufen.
• GET /api/x402/subscriptions — Scope: read; Abos und Kapazität auflisten.
• POST /api/x402/subscriptions — Scope: spend; Abo-Kapazität kaufen; Idempotency-Key unterstützt.
• PATCH /api/x402/subscriptions — Scope: write (spend bei autoRenew gleich true); Automatische Verlängerung aktualisieren.
• GET /api/x402/subscriptions/quote — Scope: read; Abo-Kapazität berechnen.
• POST /api/x402/subscriptions/trial — Scope: write; Einmaligen Test starten.
• POST /api/x402/topup — Scope: write; Auflade-Draft erstellen; Idempotency-Key unterstützt.
• GET /api/x402/topup/{handle} — Scope: read; Aufladestatus abrufen.
• POST /api/x402/topup/{handle}/confirm — Scope: write; Auflade-Transaktion bestätigen.
• GET /api/x402/watches — Scope: read; Watches auflisten.
• POST /api/x402/watches — Scope: write; Watch erstellen; Idempotency-Key unterstützt.
• GET /api/x402/watches/{id} — Scope: read; Watch abrufen.
• PATCH /api/x402/watches/{id} — Scope: write; Watch aktualisieren.
• DELETE /api/x402/watches/{id} — Scope: write; Watch löschen.