accepts، وكيف تجعل PAYMENT-SIGNATURE طلب API نفسه طلبًا مدفوعًا.
التحضيرات
تحتاج إلى تجهيز:
لا تحتاج استدعاءات X402 إلى Ace Data Cloud 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.
ملخص مخرجات البرنامج لطلب 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متطلب الدفع الخاص بـ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الخاصة بتلك API.

