Brale Baru-baru ini kami merilis versi terbaru dari API stablecoin. Proyek ini dimulai dengan tahap desain pada kuartal pertama, dilanjutkan ke tahap pengembangan pada kuartal kedua, dan akhirnya diluncurkan untuk pelanggan sungguhan tak lama setelahnya.

API memiliki banyak fungsi. Postingan ini bukanlah uraian mendetail mengenai semua fungsi tersebut. Ini hanyalah catatan tentang bagaimana saya menguji berbagai hal, sebagian besar untuk bersenang-senang, dan sebagian lagi untuk memahami bagaimana orang lain mungkin mendekatinya saat pertama kali menggunakannya.

Menggunakan LLM untuk Mengerjakan API

Terakhir kali saya mengerjakan hal seperti ini, model bahasa besar belum benar-benar menjadi bagian dari alur kerja. Kini hal itu telah berubah. Dengan Cursor dan beberapa petunjuk yang memadai, kini mudah untuk menyusun prototipe yang berfungsi dan menguji asumsi secara real time.

Saya masih suka menggunakan Postman untuk menjelajahi API, tetapi saya ingin merasakan bagaimana rasanya menggunakan Brale API dalam sesuatu yang lebih mirip dengan antarmuka nyata.

Uji Coba Pertama: Otentikasi

Saya mulai dengan alur otentikasi dasar—menggunakan client_id dan client_secret untuk mendapatkan token bearer. Tidak ada yang istimewa. Cukup untuk membuktikan bahwa kredensial berfungsi dan cakupannya tepat.

Uji kecil itu ada di sini: github.com/superduperdot/auth-app

Uji Coba Kedua: Saldo

Ini ternyata sedikit lebih rumit. Brale API mendukung berbagai jenis nilai (masing-masing mewakili aset yang berbeda) dan berbagai jenis transfer (masing-masing mewakili rantai atau jaringan). Jadi, proses untuk mengambil saldo berjalan seperti ini:

  • Dapatkan account_id yang terkait dengan kredensial Anda
  • Gunakan ID tersebut untuk mengambil daftar alamat
  • Saring hasil berdasarkan jenis: “internal” untuk memisahkan dompet kustodian
  • Lakukan iterasi melalui setiap kombinasi jenis nilai dan jenis transfer yang diketahui
  • Periksa saldo dan catat hasilnya

Aplikasi tersebut ada di sini: github.com/superduperdot/balance-app

Mencari Tipe yang Didukung

TransferTypes sudah didokumentasikan dengan baik. ValueTypes belum diungkapkan secara langsung dalam dokumen, jadi saya mengambilnya dari aplikasi langsung dan memasukkan kedua daftar tersebut ke GitHub untuk referensi di masa mendatang:

Mendapatkan harga dari titik akhir data juga berjalan dengan baik.

Pengamatan Lain

  • Jika Anda menjalankan aplikasi secara lokal, kemungkinan akan ada masalah CORS, gunakan proxy.
  • Otentikasi dilakukan di auth.brale.xyz; semua yang lain ada di api.brale.xyz.
  • Perbedaan antara account_id dan address_id masih menimbulkan bug kecil bagi saya jika saya tidak berhati-hati.
  • Aplikasi uji ini menyimpan kredensial secara lokal dan tidak aman untuk penggunaan produksi. Itu disengaja

Tidak ada yang final di sini. Pengujian ini sebagian besar berfokus pada kecepatan dan kegunaan. Tujuannya adalah untuk melihat seberapa cepat Anda dapat beralih dari kredensial ke sesuatu yang nyata, tanpa bergantung pada alat internal atau pengetahuan mendalam tentang platform.

Jika Anda sedang menjelajahi Brale API, mungkin ini dapat mempersingkat prosesnya. Jika tidak, tetap saja waktu yang dihabiskan untuk melihat bagaimana lapisan baru ini berperilaku di dunia nyata sangat berharga. CLI juga dapat membantu untuk menguji fungsionalitasnya.