accepts і як PAYMENT-SIGNATURE перетворює той самий API-запит на оплачений запит.
Підготовка
Вам потрібно підготувати:
Для виклику Ace Data Cloud API через X402 не потрібен API Token. Перший запит SDK не містить
Authorization, Gateway повертає 402 Payment Required і вимоги до оплати; після підпису SDK автоматично повторює запит.
Встановлення SDK
Вихідний код і адреси пакетів:- Репозиторій SDK: https://github.com/AceDataCloud/SDK
- Репозиторій X402 Client: https://github.com/AceDataCloud/X402Client
- npm:
@acedatacloud/sdk、@acedatacloud/x402-client - PyPI:
acedatacloud、acedatacloud-x402
acedatacloud-x402.
Вивід перевірки встановлення та імпорту в чистому тимчасовому середовищі:
- Пакети npm і PyPI є справді опублікованими пакетами, а не назвами-заповнювачами в документації.
acedatacloud-x402[cli]встановлює CLI, а підкомандаapprove-permit2може використовуватися для авторизації Permit2 у сценаріїupto.
Перший запит поверне 402
Ви можете спочатку скористатисяcurl, щоб побачити, що повертає неоплачений запит. Наведений нижче приклад не призведе до списання коштів, оскільки він не містить PAYMENT-SIGNATURE:
accepts, типова структура така:
PAYMENT-REQUIRED, щоб клієнт міг зчитувати вимоги до оплати без аналізу body.
Нижче наведено підсумок програмного виводу неоплаченого запиту до production API:
- Перший запит не містить
AuthorizationабоPAYMENT-SIGNATURE, тому повертає HTTP 402 і не призведе до списання коштів. acceptsє єдиною надійною основою для підпису цього запиту та містить доступні мережі, scheme, ліміт суми, адресу одержувача та адресу активу.networkє ідентифікатором CAIP-2, і клієнт під час вибору мережі повинен зіставляти його за рядком CAIP-2.- Максимальна сума для цього мінімального запиту чату
gpt-4o-miniстановить95215atomic USDC, тобто0.095215USDC. - Для кожного запиту слід зчитувати відповідь 402 саме цього запиту; не слід жорстко кодувати приклад суми в бізнес-коді.
Виконання повторного запиту з оплатою через SDK
Нижче наведено мінімальний приклад TypeScript. Він задаєnetwork: 'base', handler вибере payment requirement Base із відповіді 402 цього запиту; фактична сума та адреса одержувача все одно визначаються accepts:
- SDK надсилає звичайний API-запит без
Authorization. - Gateway повертає
402 Payment Requiredіaccepts. createX402PaymentHandlerвибирає payment requirement дляnetwork = 'base'і підписуєPAYMENT-SIGNATURE.- SDK повторює спробу з тим самим тілом запиту, Gateway викликає Facilitator для перевірки й розрахунку, після чого пропускає запит до цільового API.
Перегляд можливостей Facilitator
X402 API не залежить від каталогу ресурсів. Клієнт безпосередньо викликає відомий API та використовує402 Payment Required і accepts, що повертаються цим запитом у реальному часі, як єдину основу для ціни й підпису.
Оголошення можливостей Facilitator знаходиться за адресою:
/supported, /verify, /settle і поточно ввімкнені платіжні мережі, не перелічуючи ресурси API.
Адреса виробничого Facilitator Ace Data Cloud:
kinds перелічує мережі та scheme, які підтримує Facilitator. Під час фактичних викликів усе одно слід орієнтуватися на accepts, що повертається API.
Вивід Facilitator /supported:
/supportedозначає, що Facilitator має можливості перевірки й розрахунку для цих мереж і scheme.- Base і Solana обидві підтримують
exact;uptoнаразі доступний лише в Base. - Чи дозволяє конкретний API певну мережу, усе одно визначається його 402
accepts.

