पहले कोट, फिर max_price_trx के साथ ख़रीद
कनेक्ट किए गए ऐप को buy_energy और buy_bandwidth में max_price_trx भेजना ज़रूरी है। इसके बिना कॉल MAX_PRICE_REQUIRED के साथ विफल होती है — दैनिक सीमा को जानना होता है कि एक कॉल अधिकतम कितने की हो सकती है।
- मात्रा और अवधि के साथ
quote_energy(याquote_bandwidth) कॉल करें। - उपयोगकर्ता को कोट का
total_trxदिखाएँ। - उसी मात्रा और अवधि के साथ
buy_energyकॉल करें, औरmax_price_trx= कोट काtotal_trx।
max_price_trx से ऊपर जाती है, तो ख़रीद PRICE_CHANGED के साथ अस्वीकार होती है और कोई पैसा नहीं कटता। फिर से कोट लें और उपयोगकर्ता से पूछें।
API कुंजी के लिए max_price_trx वैकल्पिक है, लेकिन इसी कारण से हम इसकी सलाह देते हैं।
आइडेम्पोटेंसी कुंजियाँ
कुछ बनाने वाले टूल्सidempotency_key लेते हैं — यह उनके रूट का Idempotency-Key हेडर है। हर नई कार्रवाई के लिए नया UUID बनाएँ और टाइमआउट या खोए जवाब के बाद उसी कार्रवाई को दोबारा आज़माते समय उसे ही इस्तेमाल करें: सर्वर दोबारा पैसे काटने के बजाय पहला परिणाम लौटाता है। कुंजी 24 घंटे वैध रहती है और अधिकतम 64 अक्षरों की होती है।
वही कुंजी अलग अनुरोध के साथ
IDEMPOTENCY_KEY_REUSED से अस्वीकार होती है; जिस कुंजी का पहला अनुरोध अभी चल रहा है, वह IDEMPOTENT_REQUEST_IN_PROGRESS लौटाती है — रुकें और उसी कुंजी से दोबारा कोशिश करें।
दैनिक खर्च सीमा
हर कनेक्शन किसी भी 24 घंटे में एक तय राशि खर्च कर सकता है — 100 TRX, जब तक उपयोगकर्ता ने सहमति स्क्रीन पर या कनेक्ट किए गए ऐप में कोई और राशि न चुनी हो। सिर्फ़ खाते का मालिक सीमा हटा सकता है।- खर्च करने वाली कॉल से पहले सर्वर अधिकतम संभव लागत आरक्षित करता है: ख़रीद के लिए
max_price_trxऔर नए पते का सक्रियण; Smart Mode, पैकेज, सक्रियण और Node API प्लान के लिए उनकी कीमत; स्टेक के लिए उसकी राशि। - कॉल के बाद आरक्षण असली राशि बन जाता है, या कुछ न कटने पर छोड़ दिया जाता है। अगर परिणाम अज्ञात है (टाइमआउट), तो आरक्षण 24 घंटे रहता है — संदेह में सीमा अस्वीकार करने की ओर झुकती है।
- अपने-आप चलने वाला खर्च (
recurring) सीमा से बाहर है। - डैशबोर्ड में कनेक्ट किए गए ऐप दिखाता है कि हर ऐप ने पिछले 24 घंटों में कितना खर्च किया।
AGENT_SPEND_CAP के साथ विफल होती है:
खोई हुई ख़रीद को दोबारा आज़माने पर उसकी राशि फिर से आरक्षित होती है। सीमा के पास होने पर दोबारा कोशिश से पहले
list_orders जाँचें: पहली कॉल शायद पूरी हो चुकी हो।ऑर्डर का स्रोत
कनेक्ट किए गए ऐप द्वारा दिए गए ऑर्डर में"source": "agent" होता है — get_order, list_orders और order.updated webhook में। API कुंजी से दिए गए ऑर्डर में "source": "api" होता है।
त्रुटि कोड
MCP पर त्रुटिisError: true वाले टूल परिणाम के रूप में आती है:
बाकी सभी कोड REST API के हैं — देखें त्रुटियां।
समाप्त या रद्द टोकन को
/mcp अनुरोध पर ही HTTP 401 और WWW-Authenticate: Bearer ... error="invalid_token" मिलता है; तब MCP क्लाइंट टोकन रिफ़्रेश करते हैं या उपयोगकर्ता से फिर से साइन इन करने को कहते हैं।