Whiteboards API

Whiteboard on istunnon aikainen yhteistoiminnallinen piirtoalusta (Excalidraw konepellin alla). Kun operaattori napsauttaa sen, alusta tallentaa sekä renderöidyn PNG:n että kanonisen Excalidraw-elementti-JSON:n, tiivistettynä yhteen — jotta auditointiketju voi todistaa, että samat muodot, jotka näit ruudulla, ovat ne, jotka auditoija näkee myöhemmin.

Valkotaulun tallennus on vain Evidence-rivi, jonka kind=whiteboard. Alla oleva erillinen päätepiste on mukavuussuodatin — käytä sitä, kun välität vain valkotauluista, Evidence API kun haluat kaikki artefaktit kerralla.

Listaa istunnon valkotaulut

GET /api/v1/public/sessions/{session_id}/whiteboards — laajuus whiteboards:read

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

Palauttaa kursorisivutetut Evidence-rivit lajilla 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
}

Lataaminen + varmentaminen

Sama kuin mikä tahansa muu Evidence-rivi — hae allekirjoitettu URL Evidence-lataus-päätepisteestä, tiivistä tavut SHA-256:lla, vertaa palautettuun sha256:

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

Excalidraw-elementti-JSON

Jokaisen valkotaulurivin integrity_jsonb.whiteboard_state tallentaa kanonisen Excalidraw-näkymän, joka tuotti PNG:n. Yhdistetty sha256 ankkuroi PNG:n ja JSON:n yhteen, joten JSON:n uudelleenrenderöinti myöhemmin tuottaa tavu-identtisen PNG:n. JSON ei tarkoituksella ole julkisessa luku-muodossa — pyydä rivin /download -URL hakeaksesi raa'an .png, ja käytä SPA-puolen audit-verify-päätepistettä, kun tarvitset JSON:n uudelleenrenderöintitodisteisiin.

Yleiset virheet