Machine API संदर्भ

• OpenAPI 3.1
• llms.txt
• RFC 9727 API कैटलॉग
• Webhook payload v2 स्कीमा
• लाइव कीमतें और कैटलॉग

ऑपरेशन सूची पुराने दस्तावेज़ीकरण से कॉपी करने के बजाय उसी रजिस्ट्री से जनरेट की जाती है जिससे OpenAPI। Method, path, Scope, सशर्त Scope और idempotency समर्थन रजिस्ट्री का अनुसरण करते हैं; व्याख्याएँ operationId द्वारा अनुक्रमित अनुवादित शब्दकोश से आती हैं। अज्ञात ऑपरेशन के लिए हर भाषा में अनुवाद आवश्यक है, न कि चुपचाप अंग्रेज़ी दिखाना।

OpenAPI वर्तमान में कई ऑपरेशनों के लिए सामान्य (generic) request/response ऑब्जेक्ट उपयोग करता है। इसका सामान्य वॉलेट request उदाहरण हर POST के लिए मान्य payload नहीं है। इन वर्कफ़्लो के लिए प्रमाणीकरण, टॉपअप और Watchdog पर दिए गए जाँचे हुए उदाहरण उपयोग करें। यह दस्तावेज़ एक Discovery संदर्भ है, यह दावा नहीं कि हर रूट समान प्रतिक्रिया स्टेटस या फ़ील्ड साझा करता है।

यह मॉड्यूल x402 मशीन बिलिंग और Watchdog ऑटोमेशन को कवर करता है। मापे गए डेटा रूट अपने मौजूदा APIs का उपयोग करते हैं और अलग से सूचीबद्ध हैं। MCP एक केवल-पठन टूल इंटरफ़ेस है जिसका अलग OAuth खाता प्रवाह है; इसका कार्यान्वयन इस मॉड्यूल से नहीं बदलता। Credits और MCP उपयोगकर्ता मार्गदर्शिकाएँ अलग दस्तावेज़ीकरण खंड हैं।

• GET /api/x402/account — Scope: read; क्रेडिट बैलेंस और ledger प्राप्त करें.
• GET /api/x402/account/terms — Scope: read; शर्तों की स्वीकृति प्राप्त करें.
• POST /api/x402/account/terms — Scope: write; वर्तमान शर्तें स्वीकार करें.
• GET /api/x402/alerts — Scope: read; अलर्ट इतिहास सूचीबद्ध करें.
• DELETE /api/x402/alerts — Scope: write; चयनित अलर्ट इतिहास हटाएँ.
• DELETE /api/x402/alerts/{id} — Scope: write; एक अलर्ट हटाएँ.
• GET /api/x402/alerts/export — Scope: read; अलर्ट इतिहास CSV के रूप में export करें.
• POST /api/x402/auth/challenge — Scope: कोई प्रमाणीकरण नहीं; Scope-युक्त SIWE Challenge बनाएँ.
• POST /api/x402/auth/token — Scope: कोई प्रमाणीकरण नहीं; साइन किए गए SIWE को Bearer-Token से बदलें.
• GET /api/x402/auth/tokens — Scope: read; वॉलेट के API टोकन सूचीबद्ध करें.
• DELETE /api/x402/auth/tokens/{id} — Scope: write; API टोकन रद्द करें.
• GET /api/x402/channels — Scope: read; चैनल स्थिति सूचीबद्ध करें.
• PUT /api/x402/channels/{key} — Scope: write; इनपुट चैनल कॉन्फ़िगर करें; Idempotency-Key समर्थित.
• DELETE /api/x402/channels/{key} — Scope: write; चैनल target हटाएँ.
• POST /api/x402/channels/{key}/test — Scope: write; चैनल परीक्षण भेजें.
• POST /api/x402/message-preview — Scope: read; स्थानीयकृत संदेश का पूर्वावलोकन करें.
• GET /api/x402/openapi.json — Scope: कोई प्रमाणीकरण नहीं; यह OpenAPI दस्तावेज़ प्राप्त करें.
• GET /api/x402/pricing — Scope: कोई प्रमाणीकरण नहीं; कीमतें, उत्पाद, Watches, सिग्नल और सहायता खोजें.
• GET /api/x402/provider-fsp — Scope: read; Provider FSP दृश्य प्राप्त करें.
• GET /api/x402/recipients — Scope: read; नामित प्राप्तकर्ता सूचीबद्ध करें.
• POST /api/x402/recipients — Scope: write; इनपुट प्राप्तकर्ता बनाएँ; Idempotency-Key समर्थित.
• PATCH /api/x402/recipients/{id} — Scope: write; प्राप्तकर्ता अपडेट करें.
• DELETE /api/x402/recipients/{id} — Scope: write; प्राप्तकर्ता हटाएँ.
• POST /api/x402/recipients/{id}/test — Scope: write; प्राप्तकर्ता का परीक्षण करें.
• POST /api/x402/recipients/telegram-link — Scope: write; Telegram प्राप्तकर्ता लिंक बनाएँ.
• GET /api/x402/settings — Scope: read; सूचना सेटिंग्स प्राप्त करें.
• PUT /api/x402/settings — Scope: write; सूचना सेटिंग्स बदलें.
• GET /api/x402/stats — Scope: कोई प्रमाणीकरण नहीं; सार्वजनिक बिलिंग समग्र आँकड़े प्राप्त करें.
• GET /api/x402/subscriptions — Scope: read; सब्सक्रिप्शन और क्षमता सूचीबद्ध करें.
• POST /api/x402/subscriptions — Scope: spend; सब्सक्रिप्शन क्षमता खरीदें; Idempotency-Key समर्थित.
• PATCH /api/x402/subscriptions — Scope: write (spend जब autoRenew true हो); Auto-Renew अपडेट करें.
• GET /api/x402/subscriptions/quote — Scope: read; सब्सक्रिप्शन क्षमता का quote लें.
• POST /api/x402/subscriptions/trial — Scope: write; एक बार का ट्रायल शुरू करें.
• POST /api/x402/topup — Scope: write; टॉपअप ड्राफ्ट बनाएँ; Idempotency-Key समर्थित.
• GET /api/x402/topup/{handle} — Scope: read; टॉपअप स्थिति प्राप्त करें.
• POST /api/x402/topup/{handle}/confirm — Scope: write; टॉपअप ट्रांज़ैक्शन की पुष्टि करें.
• GET /api/x402/watches — Scope: read; Watches सूचीबद्ध करें.
• POST /api/x402/watches — Scope: write; Watch बनाएँ; Idempotency-Key समर्थित.
• GET /api/x402/watches/{id} — Scope: read; Watch प्राप्त करें.
• PATCH /api/x402/watches/{id} — Scope: write; Watch अपडेट करें.
• DELETE /api/x402/watches/{id} — Scope: write; Watch हटाएँ.