qub για προγραμματιστές

Το HTTP API έχει εκδόσεις κάτω από το /api/v1· το έγγραφο OpenAPI αναφέρει επί του παρόντος έκδοση API 1.0.0. Υποστηρίζονται τρεις διαδρομές ενσωμάτωσης:

HTTP API — η πλήρης εξωτερική επιφάνεια δημιουργείται από τις λειτουργίες που επισημαίνονται με x-audience: external στο /api/v1/openapi.json. Οι δημόσιες λειτουργίες δεν χρειάζονται διαπιστευτήρια· οι εγγραφές από τον περιηγητή χρησιμοποιούν Cloudflare Turnstile· οι κλήσεις Builder χρησιμοποιούν Authorization: Bearer qub_sk_…. Το /api/v1/upload δέχεται bytes που έχουν σφραγιστεί τοπικά, ενώ το /api/v1/seal είναι μια ρητά έμπιστη διαδρομή απλού κειμένου από την πλευρά του διακομιστή.
Διακομιστής MCP — το tools/qub-mcp είναι ένα τοπικό δυαδικό Rust για λειτουργίες δημιουργίας, ανάγνωσης και κατάστασης. Σφραγίζει τοπικά και δημοσιεύει ιδιωτικά περιτυλιγμένα qubs. Η δημοσίευση είναι απενεργοποιημένη από προεπιλογή· το create_qub απαιτεί τόσο QUB_API_KEY όσο και QUB_MCP_ALLOW_CREATE=true. Οι αναγνώσεις δέχονται είτε τον πλήρη σύνδεσμο παράδοσης με fragment είτε tx_id μαζί με key_base64url.
Embed — το <qub-embed src="https://qub.social/c/<tx_id>#<key>"> εμφανίζει ενσωματωμένα τη ζωντανή αντίστροφη μέτρηση και την αποκάλυψη. Τα δημόσια qubs χρησιμοποιούν την ίδια μορφή src χωρίς fragment. Χρησιμοποιήστε τον καρφιτσωμένο loader /embed/v1.js· το /embed.js είναι μόνο το μετακινούμενο alias.

Οι φορητές δέσμες .qub επαληθεύουν εκτός σύνδεσης την ακεραιότητα περιεχομένου, τη δέσμευση στον γύρο drand και τις υπογραφές. Η απόδειξη ότι το κρυπτοκείμενο υπήρχε έως μια συγκεκριμένη στιγμή απαιτεί επιπλέον μια επαληθευμένη συναλλαγή μόνιμης αποθήκευσης ή αγκυρωμένη απόδειξη αρχείου διαφάνειας.

Δείτε το llms.txt για τη σύνοψη προσανατολισμένη σε πράκτορες, το llms-full.txt για τη συγκεντρωτική δέσμη τεκμηρίωσης και την εμφανιζόμενη αναφορά OpenAPI για σχήματα και αποκρίσεις.