qub cho nhà phát triển

qub dành cho nhà phát triển

API HTTP được lập phiên bản tại /api/v1; tài liệu OpenAPI hiện báo cáo phiên bản API là 1.0.0. Có ba hướng tích hợp được hỗ trợ:

• API HTTP — toàn bộ bề mặt bên ngoài được tạo từ các thao tác được đánh dấu x-audience: external trong /api/v1/openapi.json. Thao tác công khai không cần thông tin xác thực; lượt ghi từ trình duyệt dùng Cloudflare Turnstile; lệnh gọi Builder dùng Authorization: Bearer qub_sk_…. /api/v1/upload nhận các byte đã niêm phong cục bộ, còn /api/v1/seal là đường dẫn văn bản thuần phía máy chủ được xác định rõ là phải tin cậy.
• Máy chủ MCP — tools/qub-mcp là tệp nhị phân Rust cục bộ cho các thao tác tạo, đọc và kiểm tra trạng thái. Công cụ niêm phong cục bộ và xuất bản các qub riêng tư đã bọc. Tính năng xuất bản bị tắt theo mặc định; create_qub yêu cầu cả QUB_API_KEY và QUB_MCP_ALLOW_CREATE=true. Thao tác đọc nhận URL chuyển giao đầy đủ có fragment, hoặc tx_id cùng key_base64url.
• Nhúng — <qub-embed src="https://qub.social/c/<tx_id>#<key>"> hiển thị trực tiếp đếm ngược và nội dung công bố ngay trong trang. qub công khai dùng cùng dạng src nhưng không có fragment. Dùng trình tải được ghim /embed/v1.js; /embed.js chỉ là bí danh di động.

Các gói .qub di động xác minh ngoại tuyến tính toàn vẹn nội dung, liên kết với vòng drand và chữ ký. Muốn chứng minh bản mã đã tồn tại trước một thời điểm cụ thể còn cần giao dịch lưu trữ vĩnh viễn đã được xác minh hoặc bằng chứng nhật ký minh bạch đã được neo.

Xem llms.txt để đọc bản tóm tắt dành cho agent, llms-full.txt để xem gói tài liệu nối liền và tài liệu tham chiếu OpenAPI đã kết xuất để xem schema cùng phản hồi.