accepts e come PAYMENT-SIGNATURE trasforma la stessa richiesta API in una richiesta già pagata.
Preparazione
Devi preparare:
Non è necessario un API Token quando si chiama l’API Ace Data Cloud tramite X402. La prima richiesta dell’SDK non include
Authorization, il Gateway restituirà 402 Payment Required e i requisiti di pagamento; l’SDK riprova automaticamente dopo la firma.
Installare l’SDK
Codice sorgente e indirizzi dei pacchetti:- Repository SDK: https://github.com/AceDataCloud/SDK
- Repository X402 Client: https://github.com/AceDataCloud/X402Client
- npm:
@acedatacloud/sdk、@acedatacloud/x402-client - PyPI:
acedatacloud、acedatacloud-x402
acedatacloud-x402.
Output di installazione e controllo degli import in un ambiente temporaneo pulito:
- Sia i pacchetti npm sia i pacchetti PyPI sono pacchetti realmente pubblicati, non nomi segnaposto nella documentazione.
acedatacloud-x402[cli]installerà la CLI e il sottocomandoapprove-permit2può essere utilizzato per l’autorizzazione Permit2 nello scenarioupto.
La prima richiesta restituirà 402
Puoi prima usarecurl per vedere cosa restituisce una richiesta non pagata. L’esempio seguente non comporterà alcun addebito, perché non include PAYMENT-SIGNATURE:
accepts, con una struttura comune come segue:
PAYMENT-REQUIRED, per consentire al client di leggere i requisiti di pagamento senza analizzare il body.
Il riepilogo dell’output del programma per una richiesta non pagata dell’API di produzione è il seguente:
- La prima richiesta non include
AuthorizationoPAYMENT-SIGNATURE, quindi restituisce HTTP 402 e non comporta alcun addebito. acceptsè l’unica base affidabile per la firma di questa richiesta e contiene le reti opzionali, lo scheme, il limite massimo dell’importo, l’indirizzo del destinatario e l’indirizzo dell’asset.networkè un identificatore CAIP-2; il client deve effettuare la corrispondenza in base alla stringa CAIP-2 quando seleziona la rete.- Il limite massimo per questa richiesta di chat minima
gpt-4o-miniè95215atomic USDC, ovvero0.095215USDC. - Ogni richiesta dovrebbe leggere la risposta 402 corrente; non codificare rigidamente gli importi di esempio nel codice aziendale.
Completare il nuovo tentativo di pagamento con l’SDK
Di seguito è riportato l’esempio TypeScript minimo. Specificanetwork: 'base'; l’handler selezionerà il payment requirement di Base dalla risposta 402 corrente; l’importo effettivo e l’indirizzo del destinatario restano soggetti a accepts:
- L’SDK invia una normale richiesta API, senza
Authorization. - Il Gateway restituisce
402 Payment Requiredeaccepts. createX402PaymentHandlerseleziona il payment requirement connetwork = 'base'e firmaPAYMENT-SIGNATURE.- L’SDK ritenta con lo stesso corpo della richiesta, e il Gateway chiama il Facilitator per verificare e regolare prima di consentire l’accesso all’API di destinazione.
Visualizzare le capacità supportate dal Facilitator
L’API X402 non dipende da un catalogo di risorse. Il client chiama direttamente un’API nota e usa402 Payment Required e accepts, restituiti in tempo reale da quella richiesta, come unica base per il prezzo e la firma.
La dichiarazione delle capacità del Facilitator si trova in:
/supported, /verify, /settle e le reti di pagamento attualmente abilitate, senza elencare le risorse API.
L’indirizzo del Facilitator di produzione di Ace Data Cloud è:
kinds restituiti elencano le reti e gli scheme supportati dal Facilitator. Durante le chiamate effettive, fare comunque riferimento agli accepts restituiti dall’API.
Output di Facilitator /supported:
/supportedindica che il Facilitator dispone delle capacità di verifica e regolamento per queste reti e scheme.- Sia Base sia Solana supportano
exact;uptoè attualmente disponibile solo su Base. - Se una specifica API consente una determinata rete dipende comunque dagli
accepts402 di quell’API.

