accepts, och hur PAYMENT-SIGNATURE gör samma API-begäran till en betald begäran.
Förberedelser
Du behöver förbereda:
X402 kräver ingen API Token vid anrop till Ace Data Cloud API. SDK:ts första begäran innehåller inte
Authorization, Gateway returnerar 402 Payment Required och betalningskrav; SDK:t försöker automatiskt igen efter signering.
Installera SDK
Källkod och paketadresser:- SDK-arkiv: https://github.com/AceDataCloud/SDK
- X402 Client-arkiv: https://github.com/AceDataCloud/X402Client
- npm:
@acedatacloud/sdk、@acedatacloud/x402-client - PyPI:
acedatacloud、acedatacloud-x402
acedatacloud-x402.
Installations- och importkontrollutdata i en ren temporär miljö:
- Både npm-paketen och PyPI-paketen är faktiskt publicerade paket, inte platshållarnamn i dokumentationen.
acedatacloud-x402[cli]installerar CLI:t, och underkommandotapprove-permit2kan användas för Permit2-auktorisering iupto-scenarier.
Den första begäran returnerar 402
Du kan först användacurl för att se vad en obetald begäran returnerar. Exemplet nedan medför ingen debitering eftersom det inte innehåller PAYMENT-SIGNATURE:
accepts-array, med en vanlig struktur enligt följande:
PAYMENT-REQUIRED, så att klienten kan läsa betalningskraven utan att parsa body.
Programutdatasammanfattningen för en obetald begäran till produktions-API:t är följande:
- Den första begäran innehåller inte
AuthorizationellerPAYMENT-SIGNATURE, så den returnerar HTTP 402 och medför ingen debitering. acceptsär den enda tillförlitliga signaturgrunden för den här begäran och innehåller valbara nätverk, scheme, beloppsgräns, mottagaradress och tillgångsadress.networkär en CAIP-2-identifierare, klienten måste matcha enligt CAIP-2-strängen när den väljer nätverk.- Det maximala beloppet för denna minimala chattbegäran med
gpt-4o-miniär95215atomic USDC, det vill säga0.095215USDC. - Varje begäran bör läsa det aktuella 402-svaret, hårdkoda inte exempelbelopp i affärskoden.
Slutför betalningsförsök igen med SDK
Nedan är ett minimalt TypeScript-exempel. Det angernetwork: 'base', handlern väljer Base payment requirement från det aktuella 402-svaret; det faktiska beloppet och mottagaradressen baseras fortfarande på accepts:
- SDK:t skickar en vanlig API-begäran utan
Authorization. - Gateway returnerar
402 Payment Requiredochaccepts. createX402PaymentHandlerväljer payment requirement förnetwork = 'base'och signerarPAYMENT-SIGNATURE.- SDK:t försöker igen med samma begärandetext, och Gateway anropar Facilitator för att verifiera och reglera innan den släpper igenom till mål-API:t.
Visa Facilitators funktioner som stöds
X402 API är inte beroende av en resurskatalog. Klienten anropar direkt ett känt API och använder402 Payment Required och accepts som returneras i realtid av den begäran som enda grund för pris och signatur.
Facilitators funktionsdeklaration finns på:
/supported, /verify, /settle och de betalningsnätverk som för närvarande är aktiverade, och listar inte API-resurser.
Ace Data Clouds produktionsadress för Facilitator är:
kinds listar de nätverk och scheman som Facilitator stöder. Vid faktiska anrop gäller fortfarande det accepts som returneras av API:t.
Utdata från Facilitator /supported:
/supportedvisar att Facilitator har kapacitet att verifiera och reglera dessa nätverk och scheman.- Både Base och Solana stöder
exact;uptoerbjuds för närvarande endast på Base. - Huruvida ett specifikt API tillåter ett visst nätverk avgörs fortfarande av API:ts 402
accepts.

