API và SDK
URL gốc là https://api.bricsfinance.fun. Toàn bộ đặc tả nằm trong tài liệu OpenAPI.
Đọc Thành phố
curl https://api.bricsfinance.fun/v1/city
curl https://api.bricsfinance.fun/v1/towers/0xYourWalletAddress
curl https://api.bricsfinance.fun/v1/addresses
curl https://api.bricsfinance.fun/v1/status
/v1/addresses liệt kê các địa chỉ chính thức trên Robinhood Chain, trong đó có token $BRICS. Hãy kiểm tra một địa chỉ ở đó trước khi tin tưởng nó.
SDK
SDK nằm trong sdk/ts của kho mã. Nó chưa có trên npm.
import { Brics } from './sdk/ts/src/index';
const brics = new Brics();
const tower = await brics.tower('0xYourWalletAddress');
Đăng nhập
POST /v1/auth/noncevới{ chain: "robinhood", address }trả cho bạn thông điệp cần ký.- Ký thông điệp bằng ví qua
personal_sign. Tài khoản thông minh ký qua EIP-1271. POST /v1/auth/verifyvới{ nonce, signature }mở một phiên. Ứng dụng dùng SDK gửi headerx-brics-client: sdkđể nhận bearer token thay cho cookie.
Mỗi nonce chỉ dùng được một lần và hết hạn sau năm phút.
Cảnh báo rủi ro
GET /v1/alerts liệt kê mọi cảnh báo đang mở và những cảnh báo đã xử lý trong 30 ngày qua, mỗi cảnh báo có mức độ (info, warn hoặc critical) và một thông điệp dễ hiểu. GET /v1/alerts/feed.xml là cùng danh sách đó dưới dạng nguồn tin Atom, và GET /v1/status kèm các cảnh báo đang mở. Mỗi tình huống chỉ mở một cảnh báo, và cảnh báo vẫn nằm trong hồ sơ sau khi đã hết. Cảnh báo không bao giờ nêu tên một người nắm giữ. Để nhận chúng ngay khi xảy ra, xem trang trạng thái.
Giới hạn
120 yêu cầu mỗi phút cho mỗi IP, và phần thân yêu cầu tối đa 64 KB. Lỗi có dạng { "error": "code", "message": "…" }.