Brale Kısa bir süre önce, stablecoin API’lerinin güncellenmiş bir sürümünü kullanıma sunduk. Proje, 1. çeyrekte bir tasarım grubu ile başladı, 2. çeyrekte geliştirme aşamasına geçti ve kısa bir süre sonra gerçek müşterilerle birlikte üretime geçti.
API'ın pek çok işlevi var. Bu yazı, tüm bu işlevlerin ayrıntılı bir incelemesi değildir. Bu yazı, çoğunlukla eğlence amacıyla, kısmen de başkalarının bu aracı ilk kez kullanırken nasıl bir yaklaşım sergileyebileceğini anlamak için yaptığım testlerin bir kaydı niteliğindedir.
API'i Kullanmak İçin Büyük Dil Modelleri (LLM'ler)
En son böyle bir şey üzerinde çalıştığımda, büyük dil modelleri iş akışının bir parçası değildi. Bu durum değişti. Cursor ve uygun komutlar sayesinde, artık çalışan prototipler oluşturmak ve varsayımları gerçek zamanlı olarak test etmek çok kolay.
API’leri keşfetmek için hâlâ Postman’ı kullanmayı seviyorum, ancak Brale API’i gerçek bir arayüze biraz daha yakın bir ortamda kullanmanın nasıl bir his olduğunu görmek istedim.
İlk Test: Kimlik Doğrulama
Temel bir kimlik doğrulama akışıyla başladım; client_id ve client_secret kullanarak bir bearer token aldım. Karmaşık bir şey yoktu. Kimlik bilgilerinin çalıştığını ve kapsamlarının doğru ayarlandığını kanıtlamak için yeterliydi.
Bu küçük test burada yer alıyor: github.com/superduperdot/auth-app
İkinci Test: Bakiyeler
Bu, biraz daha karmaşık bir iş oldu. Brale API, birden fazla değer türü (her biri farklı bir varlığı temsil eder) ve birden fazla transfer türü (her biri bir zinciri veya ağı temsil eder) destekliyor. Dolayısıyla bakiyeleri alma süreci şöyle gerçekleşti:
Kimlik bilgilerinizle ilişkili account_id'yi alın
Bu ID'yi kullanarak adres listesini alın
Sonuçları türe göre filtreleyin: “internal” seçeneğiyle saklama cüzdanlarını ayırın
Bilinen tüm değer türü ve transfer türü kombinasyonlarını tek tek inceleyin
Bakiyeleri sorgulayın ve elde edilen sonuçları kaydedin
Uygulama burada: github.com/superduperdot/balance-app
Desteklenen Türleri Takip Etme
TransferTypes iyi bir şekilde belgelenmiştir. ValueTypes henüz belgelerde doğrudan gösterilmiyor, bu yüzden bunları canlı uygulamadan aldım ve ileride başvurmak üzere her iki listeyi de GitHub’a yükledim:
Brale'in TransferTypes listesi
Brale ValueTypes listesi
Veri uç noktasından fiyat bilgisi almak da sorunsuz bir şekilde çalıştı.
Diğer Gözlemler
Yerel olarak çalıştırıyorsanız, CORS sorunları ile karşılaşabilirsiniz; bu durumda bir proxy kullanın.
Kimlik doğrulama auth.brale.xyz adresinde gerçekleşir; diğer her şey api.brale.xyz adresindedir.
Dikkatli olmazsam, account_id ve address_id arasındaki fark hâlâ benim için küçük hatalara neden oluyor.
Bu test uygulamaları kimlik bilgilerini yerel olarak depolar ve üretim ortamında kullanım için güvenli değildir. Bu kasıtlıdır
Buradaki hiçbir şey kesin değildir. Bu testler çoğunlukla hız ve kullanılabilirlikle ilgiliydi. Amaç, dahili araçlara veya platform hakkında derin bilgiye güvenmeden, kimlik bilgilerini kullanarak ne kadar hızlı bir şekilde gerçek bir sonuca ulaşabileceğinizi görmekti.
Brale'i API inceliyorsanız, belki bu yolunuzu kısaltır. İncelemiyorsanız bile, yeni katmanın gerçek ortamda nasıl davrandığını görmek için harcadığınız zamana değerdi. CLI de deneme amaçlı kullanımda yardımcı olabilir.