Brale stablecoin API’lerinin güncellenmiş bir sürümünü kısa süre önce kullanıma sunduk. Proje, ilk çeyrekte bir tasarım ekibi ile başladı, ikinci çeyrekte geliştirme aşamasına geçti ve kısa bir süre sonra gerçek müşterilerle birlikte canlı ortama geçti.

API'ın yaptığı çok şey var. Bu yazı, tüm bu işlevlerin ayrıntılı bir açıklaması değildir. Bu yazı, çoğunlukla eğlence amacıyla ve kısmen de başkalarının bunu ilk kez kullanırken nasıl bir yaklaşım sergileyebileceğini anlamak için yaptığım testlerin bir kaydıdır.

LLM'leri Kullanarak API'ı Çalıştırmak

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 bazı iyi komutlarla artık çalışan prototipleri bir araya getirmek ve varsayımları gerçek zamanlı olarak test etmek çok kolay.

Hala API'leri keşfetmek için Postman'ı kullanmayı seviyorum, ancak Brale API'yi 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 kapsamının doğru olduğunu kanıtlamak için yeterliydi.

Bu küçük test burada: github.com/superduperdot/auth-app

İkinci Test: Bakiyeler

Bu biraz daha karmaşık oldu. Brale API, birden fazla değer türünü (her biri farklı bir varlığı temsil eder) ve birden fazla transfer türünü (her biri bir zinciri veya ağı temsil eder) destekler. Dolayısıyla bakiyeleri alma süreci şöyle gerçekleşti:

  • Kimlik bilgilerinizle ilişkili account_id'yi alın
  • Bu kimliği kullanarak adres listesini alın
  • Sonuçları türe göre filtreleyin: "internal" seçeneğini kullanarak 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 sonuçları kaydedin

Bu 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 ekledim:

Veri uç noktasından fiyat bilgisi almak da sorunsuz çalıştı.

Diğer Gözlemler

  • Yerel olarak çalıştırıyorsanız, CORS sorunları bekleyin, bir proxy kullanın.
  • Kimlik doğrulama auth.brale.xyz adresinde gerçekleşir; diğer her şey api.brale.xyz adresindedir.
  • account_id ve address_id arasındaki fark, dikkatli olmazsam hala 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 keşfediyorsanız, belki bu yolunuzu kısaltır. Keşfetmiyorsanı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 aşamasında yardımcı olabilir.