accepts befindet und wie PAYMENT-SIGNATURE dieselbe API-Anfrage in eine bezahlte Anfrage verwandelt.
Vorbereitung
Du musst Folgendes vorbereiten:
Bei X402-Aufrufen der Ace Data Cloud API ist kein API-Token erforderlich. Die erste SDK-Anfrage enthält kein
Authorization, das Gateway gibt 402 Payment Required und die Zahlungsanforderungen zurück; nach der SDK-Signatur wird automatisch erneut versucht.
SDK installieren
Quellcode und Paketadressen:- SDK-Repository: https://github.com/AceDataCloud/SDK
- X402-Client-Repository: https://github.com/AceDataCloud/X402Client
- npm:
@acedatacloud/sdk、@acedatacloud/x402-client - PyPI:
acedatacloud、acedatacloud-x402
acedatacloud-x402 enthalten.
Installations- und Importprüfungs-Ausgabe in einer sauberen temporären Umgebung:
- Sowohl npm-Pakete als auch PyPI-Pakete sind tatsächlich veröffentlichte Pakete und keine Platzhalternamen in der Dokumentation.
acedatacloud-x402[cli]installiert die CLI; der Unterbefehlapprove-permit2kann für Permit2-Autorisierungen imupto-Szenario verwendet werden.
Die erste Anfrage gibt 402 zurück
Du kannst zunächst mitcurl prüfen, was eine unbezahlte Anfrage zurückgibt. Das folgende Beispiel verursacht keine Belastung, da es keine PAYMENT-SIGNATURE enthält:
accepts-Array, dessen übliche Struktur wie folgt aussieht:
PAYMENT-REQUIRED abgelegt, damit der Client die Zahlungsanforderungen lesen kann, ohne den Body zu parsen.
Die folgende Programmausgabe-Zusammenfassung stammt von einer unbezahlten Anfrage an die Produktions-API:
- Die erste Anfrage enthält weder
AuthorizationnochPAYMENT-SIGNATURE, daher wird HTTP 402 zurückgegeben und keine Belastung verursacht. acceptsist die einzige vertrauenswürdige Signaturgrundlage für diese Anfrage und enthält optionale Netzwerke, Schemes, Betragsobergrenzen, Empfangsadressen und Asset-Adressen.networkist eine CAIP-2-Kennung; der Client muss bei der Netzwerkauswahl anhand der CAIP-2-Zeichenfolge übereinstimmen.- Die Betragsobergrenze für diese minimale Chat-Anfrage mit
gpt-4o-minibeträgt95215atomic USDC, also0.095215USDC. - Für jede Anfrage sollte die jeweilige 402-Antwort gelesen werden; Beispielbeträge dürfen nicht fest im Geschäftscode codiert werden.
Zahlungswiederholung mit dem SDK abschließen
Im Folgenden steht ein minimales TypeScript-Beispiel. Es gibtnetwork: 'base' an, und der Handler wählt aus der jeweiligen 402-Antwort die Zahlungsanforderung für Base aus; der tatsächliche Betrag und die Empfangsadresse richten sich weiterhin nach accepts:
- Das SDK sendet eine gewöhnliche API-Anfrage ohne
Authorization. - Das Gateway gibt
402 Payment Requiredundacceptszurück. createX402PaymentHandlerwählt die payment requirement vonnetwork = 'base'aus und signiertPAYMENT-SIGNATURE.- Das SDK wiederholt die Anfrage mit demselben Anfragekörper, und das Gateway ruft den Facilitator zur Verifizierung und Abwicklung auf, bevor es die Anfrage an die Ziel-API weiterleitet.
Unterstützte Fähigkeiten des Facilitators anzeigen
Die X402 API ist nicht von einem Ressourcenverzeichnis abhängig. Der Client ruft die bekannte API direkt auf und verwendet das von dieser Anfrage in Echtzeit zurückgegebene402 Payment Required und accepts als einzige Grundlage für Preis und Signatur.
Die Fähigkeitserklärung des Facilitators befindet sich unter:
/supported, /verify, /settle und die aktuell aktivierten Zahlungsnetzwerke, und listet keine API-Ressourcen auf.
Die Produktions-Facilitator-Adresse von Ace Data Cloud lautet:
kinds listen die vom Facilitator unterstützten Netzwerke und Schemes auf. Bei tatsächlichen Aufrufen gelten weiterhin die von der API zurückgegebenen accepts.
Facilitator-/supported-Ausgabe:
/supportedzeigt, dass der Facilitator über Verifizierungs- und Abwicklungsfähigkeiten für diese Netzwerke und Schemes verfügt.- Base und Solana unterstützen beide
exact;uptowird derzeit nur auf Base angeboten. - Ob eine konkrete API ein bestimmtes Netzwerk zulässt, richtet sich weiterhin nach den 402-
acceptsdieser API.

