API और एजेंट

Watchdog पेज पर आप जो कुछ भी करते हैं, वह /api/x402 के तहत भी उपलब्ध है: वॉचेस की सूची देखना और बनाना, सिग्नल और रूटिंग बदलना, प्राप्तकर्ता प्रबंधित करना और टेस्ट भेजना, अलर्ट इतिहास पढ़ना और निर्यात करना, कीमतें देखना, स्लॉट खरीदना और क्रेडिट टॉप-अप करना। API से किए गए बदलाव ऐप में तुरंत दिखते हैं, और ऐप में किए गए बदलाव API में।

मशीन पासवर्ड से नहीं, वॉलेट से साइन इन करती है। इस प्रक्रिया में पाँच चरण हैं:

1. POST /api/x402/auth/challenge, वॉलेट पते, अनुरोधित scopes और टोकन के एक वैकल्पिक नाम के साथ।
2. जवाब में SIWE फ़ॉर्मेट (EIP-4361) में एक साइन-इन संदेश होता है। यह 5 मिनट तक मान्य है और अनुरोधित scopes सूचीबद्ध करता है।
3. वॉलेट संदेश पर हस्ताक्षर करता है। EIP-1271 का समर्थन करने वाले smart-contract वॉलेट भी काम करते हैं।
4. POST /api/x402/auth/token, संदेश और हस्ताक्षर के साथ।
5. जवाब में fbx_ से शुरू होने वाला एक टोकन और उसकी समाप्ति होती है, डिफ़ॉल्ट रूप से 24 घंटे। मशीन इसे हेडर Authorization: Bearer में भेजती है।

टोकन केवल उसी जवाब में दिखाया जाता है। इसे पासवर्ड की तरह सुरक्षित रखें।

• read हमेशा शामिल होता है: वॉचेस, प्राप्तकर्ता, अलर्ट, कीमतें और खाता पढ़ना।
• write बदलावों की अनुमति देता है: वॉचेस, प्राप्तकर्ता और सेटिंग्स बनाना और संपादित करना।
• spend उन कार्रवाइयों की अनुमति देता है जिनमें क्रेडिट खर्च होते हैं, जैसे स्लॉट खरीदना।

उदाहरण: केवल अलर्ट दिखाने वाले डैशबोर्ड को read चाहिए। नए टीम सदस्यों के लिए वॉचेस सेट अप करने वाले बॉट को read और write चाहिए। जो एजेंट खुद स्लॉट भी खरीदता है, उसे read, write और spend चाहिए। अगर कोई scope नहीं है, तो API कोड insufficient_scope के साथ 403 जवाब देता है और ज़रूरी scope बताता है।

आपके वॉलेट के सभी टोकन खाता सेटिंग्स → API पहुँच में नाम, बनाने की तारीख, समाप्ति और आखिरी उपयोग के साथ सूचीबद्ध हैं। रद्द करें टोकन को तुरंत रोक देता है; इसे वापस नहीं किया जा सकता। एक वॉलेट के पास एक साथ अधिकतम 10 सक्रिय टोकन हो सकते हैं। मशीनें DELETE /api/x402/auth/tokens/{id} से खुद भी टोकन रद्द कर सकती हैं।

जो अनुरोध कुछ बनाते हैं या जिनमें क्रेडिट लगते हैं, उन्हें हेडर Idempotency-Key चाहिए, यानी 8 से 128 अक्षरों, अंकों, _ या - से बना एक मान। अगर कनेक्शन टूट जाता है, तो मशीन वही अनुरोध उसी key के साथ फिर भेजती है और दो बार भुगतान करने के बजाय पहला परिणाम पाती है। अलग अनुरोध के साथ वही key idempotency_key_reused के साथ अस्वीकार कर दी जाती है।

अगर किसी वॉच को स्लॉट चाहिए या बैलेंस कम है, तो API 402 जवाब देता है। जवाब में कोड slot_required या insufficient_credits, खरीद का एक तैयार सुझाव और टॉप-अप के लिए endpoint होता है। फिर एजेंट खुद फ़ैसला कर सकता है, या पहले आपसे पूछ सकता है।

• सभी operations का OpenAPI विवरण, scopes और error codes सहित।
• आपके webhook को मिलने वाले अलर्ट के लिए Webhook schema v2।
• भाषा मॉडलों के लिए छोटे प्रवेश बिंदु के रूप में llms.txt।
• RFC 9727 के अनुसार API कैटलॉग।
• लोगों के लिए कोड उदाहरणों के साथ API दस्तावेज़।

Model Context Protocol के लिए एक सर्वर, जिससे AI सहायक सीधे जुड़ सकते हैं, योजना में है लेकिन अभी उपलब्ध नहीं है। तब तक एजेंट ऊपर बताए गए HTTP API का उपयोग करते हैं।