Brale हाल ही में ने अपडेटेड संस्करण जारी किया। यह प्रोजेक्ट Q1 में एक डिज़ाइन कोहोर्ट के साथ शुरू हुआ, Q2 में डेवलपमेंट में गया, और थोड़ी ही देर बाद असली ग्राहकों के साथ प्रोडक्शन में पहुँच गया।
API बहुत कुछ करता है। यह पोस्ट उन सभी कार्यक्षमताओं का विस्तृत विवरण नहीं है। यह केवल एक रिकॉर्ड है कि मैं मुख्यतः मज़े के लिए और आंशिक रूप से यह समझने के लिए कि अन्य लोग पहली बार इसका उपयोग कैसे कर सकते हैं, चीज़ों का परीक्षण कैसे कर रहा हूँ।
API के माध्यम से काम करने के लिए एलएलएम का उपयोग
पिछली बार जब मैं इस तरह के किसी काम पर काम कर रहा था, तब बड़े भाषा मॉडल वास्तव में वर्कफ़्लो का हिस्सा नहीं थे। अब यह बदल गया है। Cursor और कुछ अच्छी प्रॉम्प्टिंग के साथ, अब काम करने वाले प्रोटोटाइप बनाना और वास्तविक समय में धारणाओं का परीक्षण करना आसान हो गया है।
मुझे अभी भी एपीआई का पता लगाने के लिए पोस्टमैन का उपयोग करना पसंद है, लेकिन मैं यह देखना चाहता था कि किसी वास्तविक इंटरफ़ेस के करीब कुछ चीज़ों के अंदर BraleAPI का उपयोग करने का अनुभव कैसा होता है।
पहला परीक्षण: ऑथ
मैंने एक बेसिक ऑथेंटिकेशन फ्लो से शुरुआत की—एक बेयरर टोकन पाने के लिए क्लाइंट_आईडी और क्लाइंट_सीक्रेट का उपयोग किया। कुछ खास नहीं। बस इतना कि यह साबित हो सके कि क्रेडेंशियल काम कर रहे थे और सही तरीके से स्कोप किए गए थे।
वह छोटा टेस्ट यहाँ है: github.com/superduperdot/auth-app
दूसरा परीक्षण: बैलेंस
यह थोड़ा अधिक जटिल निकला। Brale API कई प्रकार के मान (प्रत्येक एक अलग संपत्ति का प्रतिनिधित्व करता है) और कई प्रकार के हस्तांतरण (प्रत्येक एक श्रृंखला या नेटवर्क का प्रतिनिधित्व करता है) का समर्थन करता है। इसलिए बैलेंस प्राप्त करने की प्रक्रिया इस प्रकार थी:
- अपने क्रेडेंशियल्स से संबंधित account_id प्राप्त करें
- उस आईडी का उपयोग करके पतों की सूची प्राप्त करें
- परिणामों को प्रकार के अनुसार फ़िल्टर करें: कस्टोडियल वॉलेट को अलग करने के लिए "internal"
- हर ज्ञात मूल्य प्रकार और स्थानांतरण प्रकार के संयोजन के लिए दोहराएँ
- बैलेंस क्वेरी करें और जो रिटर्न मिलता है उसे लॉग करें
वह ऐप यहाँ है: github.com/superduperdot/balance-app
समर्थित प्रकारों का पता लगाना
TransferTypes अच्छी तरह से दस्तावेजीकृत हैं। ValueTypes अभी तक दस्तावेज़ों में सीधे उपलब्ध नहीं हैं, इसलिए मैंने उन्हें लाइव एप्लिकेशन से निकाला और भविष्य के संदर्भ के लिए दोनों सूचियाँ GitHub पर डाल दीं:
- Brale ट्रांसफर टाइप्स की सूची
- Brale वैल्यूटाइप्स की सूची
डेटा एंडपॉइंट से प्राइसिंग प्राप्त करना भी अच्छी तरह से काम किया।
अन्य अवलोकन
- यदि आप लोकल रूप से चला रहे हैं, तो CORS समस्याओं की उम्मीद करें, एक प्रॉक्सी का उपयोग करें।
- प्रमाणीकरण auth.brale.xyz पर होता है; बाकी सब कुछ api.brale.xyz पर है।
- account_id और address_id के बीच का अंतर अगर मैं सावधान न रहूँ तो अभी भी मेरे लिए छोटे बग्स पैदा करता है।
- ये टेस्ट ऐप्स क्रेडेंशियल्स को लोकल रूप से स्टोर करते हैं और प्रोडक्शन उपयोग के लिए सुरक्षित नहीं हैं। यह जानबूझकर क
यहाँ कुछ भी अंतिम नहीं है। ये परीक्षण मुख्य रूप से गति और उपयोगिता के बारे में थे। लक्ष्य यह देखना था कि आप आंतरिक टूलिंग या प्लेटफ़ॉर्म के गहरे ज्ञान पर निर्भर हुए बिना, प्रमाण-पत्रों से किसी वास्तविक चीज़ तक कितनी जल्दी पहुँच सकते हैं।
यदि आप Brale API का अन्वेषण कर रहे हैं, तो शायद यह रास्ता छोटा कर दे। यदि नहीं, तो भी यह देखने के लिए समय देना सार्थक था कि नई परत वास्तविक दुनिया में कैसे व्यवहार करती है। CLI भी परीक्षण करने में सहायक हो सकता है।