Chuyển đến nội dung

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

  1. POST /v1/auth/nonce với { chain: "robinhood", address } trả cho bạn thông điệp cần ký.
  2. Ký thông điệp bằng ví qua personal_sign. Tài khoản thông minh ký qua EIP-1271.
  3. POST /v1/auth/verify với { nonce, signature } mở một phiên. Ứng dụng dùng SDK gửi header x-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": "…" }.