Brale Gần đây, chúng tôi đã phát hành phiên bản cập nhật của các API thuộc dự án “stablecoin”. Dự án bắt đầu với giai đoạn thiết kế vào quý 1, chuyển sang giai đoạn phát triển vào quý 2 và nhanh chóng được đưa vào vận hành chính thức với các khách hàng thực tế ngay sau đó.
API có rất nhiều chức năng. Bài viết này không phải là bản phân tích chi tiết về tất cả các chức năng đó. Đây chỉ là ghi chép về cách tôi đã thử nghiệm các tính năng này, chủ yếu là để giải trí, và một phần để hiểu cách những người khác có thể tiếp cận và sử dụng nó lần đầu tiên.
Sử dụng các mô hình ngôn ngữ lớn (LLMs) để làm việc với API
Lần cuối cùng tôi làm việc với một dự án tương tự, các mô hình ngôn ngữ lớn (LLMs) chưa thực sự là một phần của quy trình làm việc. Điều đó đã thay đổi. Với Cursor và một số lời nhắc (prompt) phù hợp, giờ đây việc tạo ra các nguyên mẫu hoạt động và kiểm tra các giả định theo thời gian thực trở nên dễ dàng hơn bao giờ hết.
Tôi vẫn thích sử dụng Postman để khám phá các API, nhưng tôi muốn trải nghiệm cảm giác sử dụng Brale API trong một môi trường gần gũi hơn với giao diện thực tế.
Thử nghiệm đầu tiên: Xác thực
Tôi bắt đầu với quy trình xác thực cơ bản – sử dụng client_id và client_secret để lấy token bearer. Không có gì phức tạp. Chỉ đủ để chứng minh thông tin đăng nhập hoạt động và được giới hạn phạm vi đúng cách.
Thử nghiệm nhỏ đó có tại đây: github.com/superduperdot/auth-app
Thử nghiệm thứ hai: Số dư
Việc này hóa ra phức tạp hơn một chút. Brale API hỗ trợ nhiều loại giá trị (mỗi loại đại diện cho một tài sản riêng biệt) và nhiều loại chuyển khoản (mỗi loại đại diện cho một chuỗi hoặc mạng). Vì vậy, quy trình truy xuất số dư diễn ra như sau:
Lấy account_id liên quan đến thông tin đăng nhập của bạn
Sử dụng ID đó để lấy danh sách các địa chỉ
Lọc kết quả theo loại: “internal” để tách riêng các ví lưu ký
Lặp qua mọi kết hợp loại giá trị và loại chuyển khoản đã biết
Tra cứu số dư và ghi lại kết quả trả về
Ứng dụng đó có tại đây: github.com/superduperdot/balance-app
Tìm kiếm các loại được hỗ trợ
Các loại chuyển khoản (TransferTypes) đã được tài liệu hóa đầy đủ. Các loại giá trị (ValueTypes) hiện chưa được công bố trực tiếp trong tài liệu, vì vậy tôi đã trích xuất chúng từ ứng dụng đang hoạt động và đăng cả hai danh sách lên GitHub để tham khảo trong tương lai:
Danh sách các loại chuyển khoản (TransferTypes) của Brale
Danh sách các ValueTypes của Brale
Việc lấy giá từ điểm cuối dữ liệu cũng hoạt động tốt.
Các quan sát khác
Nếu bạn đang chạy ứng dụng trên máy cục bộ, hãy chuẩn bị đối phó với các vấn đề liên quan đến CORS và sử dụng proxy.
Quá trình xác thực diễn ra tại auth.brale.xyz; mọi thứ khác đều diễn ra tại api.brale.xyz.
Sự khác biệt giữa account_id và address_id vẫn gây ra một số lỗi nhỏ cho tôi nếu tôi không cẩn thận.
Các ứng dụng thử nghiệm này lưu trữ thông tin đăng nhập cục bộ và không an toàn để sử dụng trong môi trường sản xuất. Điều này là có chủ đích
Không có gì ở đây là cuối cùng. Các bài kiểm tra này chủ yếu tập trung vào tốc độ và tính tiện dụng. Mục tiêu là xem bạn có thể chuyển từ thông tin đăng nhập sang một ứng dụng thực tế nhanh như thế nào, mà không cần dựa vào các công cụ nội bộ hay kiến thức sâu về nền tảng.
Nếu bạn đang khám phá "Brale" API, có lẽ điều này sẽ rút ngắn con đường. Ngay cả khi không, việc dành thời gian để xem lớp mới này hoạt động như thế nào trong thực tế vẫn rất đáng giá. CLI cũng có thể hữu ích để thử nghiệm sơ bộ.