accepts oraz w jaki sposób PAYMENT-SIGNATURE zmienia to samo żądanie API w opłacone żądanie.
Przygotowanie
Musisz przygotować:
Podczas wywoływania Ace Data Cloud API przez X402 nie jest wymagany API Token. Pierwsze żądanie SDK nie zawiera
Authorization, Gateway zwróci 402 Payment Required oraz wymagania płatności; po podpisaniu SDK automatycznie ponowi próbę.
Instalacja SDK
Adresy źródeł i pakietów:- Repozytorium SDK: https://github.com/AceDataCloud/SDK
- Repozytorium X402 Client: https://github.com/AceDataCloud/X402Client
- npm:
@acedatacloud/sdk、@acedatacloud/x402-client - PyPI:
acedatacloud、acedatacloud-x402
acedatacloud-x402.
Wynik instalacji i sprawdzenia importów w czystym środowisku tymczasowym:
- Zarówno pakiety npm, jak i PyPI są rzeczywiście opublikowanymi pakietami, a nie nazwami zastępczymi w dokumentacji.
acedatacloud-x402[cli]zainstaluje CLI, a podkomendaapprove-permit2może być używana do autoryzacji Permit2 w scenariuszuupto.
Pierwsze żądanie zwróci 402
Możesz najpierw użyćcurl, aby zobaczyć, co zwraca nieopłacone żądanie. Poniższy przykład nie spowoduje obciążenia, ponieważ nie zawiera PAYMENT-SIGNATURE:
accepts, której typowa struktura jest następująca:
PAYMENT-REQUIRED, aby klient mógł odczytać wymagania płatności bez parsowania body.
Podsumowanie wyjścia programu dla nieopłaconego żądania produkcyjnego API jest następujące:
- Pierwsze żądanie nie zawiera
AuthorizationaniPAYMENT-SIGNATURE, dlatego zwraca HTTP 402 i nie powoduje obciążenia. acceptsjest jedyną wiarygodną podstawą podpisu dla tego żądania i zawiera dostępne sieci, scheme, limit kwoty, adres odbiorcy oraz adres aktywa.networkjest identyfikatorem CAIP-2; podczas wyboru sieci klient musi dopasować ciąg CAIP-2.- Limit kwoty dla tego minimalnego żądania czatu
gpt-4o-miniwynosi95215atomic USDC, czyli0.095215USDC. - Dla każdego żądania należy odczytać bieżącą odpowiedź 402; nie należy na stałe kodować przykładowej kwoty w kodzie biznesowym.
Ukończenie ponownej próby płatności za pomocą SDK
Poniżej znajduje się minimalny przykład TypeScript. Określa onnetwork: 'base', a handler wybierze wymaganie płatności Base z bieżącej odpowiedzi 402; rzeczywista kwota i adres odbiorcy nadal są określane przez accepts:
- SDK wysyła zwykłe żądanie API bez
Authorization. - Gateway zwraca
402 Payment Requiredorazaccepts. createX402PaymentHandlerwybiera payment requirement dlanetwork = 'base'i podpisujePAYMENT-SIGNATURE.- SDK ponawia żądanie z tym samym body, a Gateway wywołuje Facilitator w celu weryfikacji i rozliczenia, po czym przepuszcza je do docelowego API.
Sprawdzanie obsługiwanych możliwości Facilitator
X402 API nie zależy od katalogu zasobów. Klient bezpośrednio wywołuje znane API i wykorzystuje zwrócone w czasie rzeczywistym przez to żądanie402 Payment Required oraz accepts jako jedyną podstawę ceny i podpisu.
Deklaracja możliwości Facilitator znajduje się pod adresem:
/supported, /verify, /settle oraz aktualnie włączone sieci płatności, nie wymienia zasobów API.
Adres produkcyjnego Facilitator Ace Data Cloud to:
kinds wyświetlą sieci i scheme obsługiwane przez Facilitator. Podczas rzeczywistych wywołań nadal należy kierować się accepts zwróconym przez API.
Wynik /supported Facilitator:
/supportedwskazuje, że Facilitator ma możliwości weryfikacji i rozliczania dla tych sieci i scheme.- Zarówno Base, jak i Solana obsługują
exact;uptojest obecnie dostępne tylko w Base. - To, czy konkretne API zezwala na daną sieć, nadal zależy od 402
acceptstego API.

