Whiteboards API

Ένας Whiteboard είναι μια συνεργατική επιφάνεια σχεδίασης εντός συνεδρίας (Excalidraw από κάτω). Όταν ο χειριστής τον αποτυπώνει, η πλατφόρμα καταγράφει και το αποτυπωμένο PNG και το κανονικοποιημένο JSON στοιχείων Excalidraw, κατακερματισμένα μαζί — ώστε η αλυσίδα ελέγχου να μπορεί να αποδείξει ότι τα ίδια σχήματα που είδατε στην οθόνη είναι αυτά που βλέπει αργότερα ο ελεγκτής.

Μια αποτύπωση πίνακα ζωγραφικής είναι απλώς μια εγγραφή Evidence με kind=whiteboard. Το ειδικό endpoint παρακάτω είναι ένα φίλτρο ευκολίας — χρησιμοποιήστε το όταν σας ενδιαφέρουν μόνο οι πίνακες ζωγραφικής, το Evidence API όταν θέλετε όλα τα τεκμήρια ταυτόχρονα.

Λίστα πινάκων ζωγραφικής για μια συνεδρία

GET /api/v1/public/sessions/{session_id}/whiteboards — εύρος whiteboards:read

curl "https://app.nexbasira.com/api/v1/public/sessions/0c8f.../whiteboards?limit=25" \
  -H "Authorization: Bearer nb_sec_..."

Επιστρέφει εγγραφές Evidence με σελιδοποίηση cursor του τύπου kind=whiteboard.

{
  "data": [
    {
      "id": "ev-wb1...",
      "session": "0c8f...",
      "kind": "whiteboard",
      "status": "ready",
      "mime": "image/png",
      "byte_size": 42178,
      "sha256": "8e2c01...",
      "captured_at": "2026-05-23T10:18:44Z",
      "created_at":  "2026-05-23T10:18:44Z",
      "completed_at":"2026-05-23T10:18:45Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Λήψη + επαλήθευση

Όπως κάθε άλλη εγγραφή Evidence — ανακτήστε ένα υπογεγραμμένο URL από το endpoint λήψης Evidence, κατακερματίστε τα bytes με SHA-256, συγκρίνετε με το επιστρεφόμενο sha256:

curl "https://app.nexbasira.com/api/v1/public/evidence/ev-wb1.../download" \
  -H "Authorization: Bearer nb_sec_..."

JSON στοιχείων Excalidraw

Το πεδίο κάθε εγγραφής πίνακα ζωγραφικής integrity_jsonb.whiteboard_state αποθηκεύει την κανονικοποιημένη σκηνή Excalidraw που παρήγαγε το PNG. Το συνδυασμένο sha256 αγκυρώνει το PNG και το JSON μαζί, ώστε η εκ νέου απόδοση του JSON αργότερα να δίνει ένα byte-identical PNG. Το JSON σκόπιμα δεν βρίσκεται στη δημόσια μορφή ανάγνωσης — ζητήστε το URL /download για την εγγραφή ώστε να ανακτήσετε το ακατέργαστο .png, και χρησιμοποιήστε το endpoint audit-verify στην πλευρά SPA όταν χρειάζεστε το JSON για αποδείξεις εκ νέου απόδοσης.

Συνήθη σφάλματα