मुख्य सामग्री पर जाएं

पहले कोट, फिर max_price_trx के साथ ख़रीद

कनेक्ट किए गए ऐप को buy_energy और buy_bandwidth में max_price_trx भेजना ज़रूरी है। इसके बिना कॉल MAX_PRICE_REQUIRED के साथ विफल होती है — दैनिक सीमा को जानना होता है कि एक कॉल अधिकतम कितने की हो सकती है।
  1. मात्रा और अवधि के साथ quote_energy (या quote_bandwidth) कॉल करें।
  2. उपयोगकर्ता को कोट का total_trx दिखाएँ।
  3. उसी मात्रा और अवधि के साथ 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 पर वही कोड मानक त्रुटि प्रारूप में आता है। बाकी सभी कोड REST API के हैं — देखें त्रुटियां। समाप्त या रद्द टोकन को /mcp अनुरोध पर ही HTTP 401 और WWW-Authenticate: Bearer ... error="invalid_token" मिलता है; तब MCP क्लाइंट टोकन रिफ़्रेश करते हैं या उपयोगकर्ता से फिर से साइन इन करने को कहते हैं।