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 Dịch vụ Quản lý Dữ liệu (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à bản ghi lại cách tôi đã thử nghiệm các chức năng này, chủ yếu là để giải trí, và một phần là để hiểu cách những người khác có thể tiếp cận việc sử dụng nó lần đầu tiên.

Sử dụng LLM để 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) hợp lý, giờ đây việc tạo ra các bản mẫu hoạt động và kiểm tra giả định trong thời gian thực trở nên dễ dàng.

Tôi vẫn thích sử dụng Postman để khám phá các API, nhưng tôi muốn xem cảm giác sử dụng Ứng dụng API (Brale) API trong một môi trường gần gũi hơn với giao diện thực tế như thế nào.

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 mã thông báo bearer. Không có gì phức tạp. Chỉ đủ để chứng minh thông tin đăng nhập hoạt động và được định 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ư

Điều 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 lấy 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 lại 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ả

Ứ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 TransferTypes đã được ghi chép đầy đủ. Các ValueTypes chưa được công bố trực tiếp trong tài liệu, vì vậy tôi đã lấy chúng từ ứng dụng đang hoạt động và đưa cả hai danh sách vào GitHub để tham khảo trong tương lai:

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 trên máy cục bộ, hãy chuẩn bị cho 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 thử nghiệm này chủ yếu tập trung vào tốc độ và tính dễ sử 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ó thể điều này sẽ rút ngắn con đường. Nếu không, việc dành thời gian để xem lớp mới hoạt động như thế nào trong môi trường thực tế vẫn đáng giá. Giao diện dòng lệnh (CLI) cũng có thể hữu ích để kiểm tra sơ bộ.