API công khai

Yêu cầu	Kết quả
GET /api/v1	Phiên bản, môi trường, các chuỗi được hỗ trợ và khả năng
GET /api/v1/collections?limit=20&offset=0&chain=84532	Cấu hình công khai của bộ sưu tập và các liên kết tích hợp
GET /api/v1/collections/84532/{contract_address}	Một bộ sưu tập đã đăng ký, kèm số liệu chuỗi khối được lưu đệm
GET /api/v1/contracts/kurvdrop	ABI công khai của KurvDrop, gồm cả báo giá và việc đúc

const origin = 'https://testnet.kurv.fun';
const { collections } = await fetch(`${origin}/api/v1/collections?limit=20`)
  .then(response => response.json());
const collection = collections[0];
const { collection: current } = await fetch(
  `${origin}/api/v1/collections/${collection.chain_id}/${collection.contract_address}`
).then(response => response.json());

Mọi route API công khai đều gửi Access-Control-Allow-Origin: * và chỉ chấp nhận thao tác đọc. Chúng không cần cookie. Danh sách chấp nhận giới hạn từ 1 đến 50 và độ lệch từ 0 đến 200; pagination.next_offset là null ở cuối danh sách. Phiên bản 1 cung cấp một cửa sổ gồm 200 bản ghi danh mục hiển thị mới nhất, không phải một chỉ mục lịch sử không giới hạn. Route chi tiết cũng hỗ trợ các bộ sưu tập đã đăng ký được truy cập bằng địa chỉ trực tiếp.

Số tiền và số lượng nguồn cung là chuỗi thập phân, giữ nguyên độ chính xác của số nguyên. Số tiền dùng đơn vị nhỏ nhất của token thanh toán của bộ sưu tập. Hãy đọc decimals() và symbol() của token đó trước khi định dạng; đừng bao giờ mặc định mọi bộ sưu tập đều thanh toán bằng USDC sáu chữ số thập phân. max_supply lấy từ cấu hình ra mắt cho đến khi có trạng thái trên chuỗi khối. total_minted là null cho đến khi có dữ liệu đọc, thay vì một số không bịa ra.

Các lần đọc chi tiết dùng lại bộ đệm chuỗi khối 15 giây dùng chung của KURV. reading.read_at ghi lại thời điểm một lần đọc thành công; reading.status: "stale_or_unavailable" nghĩa là lần thử gần nhất đã thất bại và mọi số liệu đều thuộc về lần đọc thành công gần nhất. Báo giá trong phản hồi này chỉ mang tính thông tin, cho một NFT trong giai đoạn đang hoạt động mặc định, và không chứng minh rằng ví có thể đúc. Hãy lấy quoteMint mới ngay trước khi ký.

Media của token chưa tiết lộ và gốc metadata được giữ kín. Một ảnh giới thiệu được xuất bản riêng vẫn có thể hiển thị. Danh sách cho phép riêng tư, danh sách tệp xuất bản, mã seed, thông tin xác thực tài khoản và lỗi hạ tầng thô không bao giờ có trong phiên bản 1. Lỗi dùng dạng { "api_version": "1", "error": { "code": "...", "message": "..." } } với mã trạng thái 400, 404 hoặc 503.

Dùng https://testnet.kurv.fun cho Base Sepolia, chain id 84532. KURV cho nhà phát triển liệt kê các điểm truy cập hiện có. Giá và phí phụ thuộc vào bộ sưu tập: hãy đọc Phí và Rủi ro và tuyên bố miễn trừ.