OtterSafe — rejestr eksportu i interfejs przenoszenia danych Wersja dokumentacji: 2026-11-19. Format eksportu: schemaVersion 1. 1. Dostęp Eksport jest bezpłatny. Ustawienia > Profil > Kopia dokumentacji; pojedyncza kartoteka: Eksportuj dokumentację. Potrzebne jest odblokowanie E2EE. Wybór miejsc pracy nie rozszerza uprawnień użytkownika. Właściciel gabinetu nie otrzymuje przez eksport dokumentacji klinicznej innych terapeutów. Przeniesienie całej organizacji wymaga osobnego uzgodnienia zakresu: kontakt@ottersafe.pl. Eksport terapeuty nie obejmuje kompletnej konfiguracji pomieszczeń, zespołu i uprawnień całego gabinetu. 2. Format pobranego archiwum ZIP, nazwy UTF-8; PDF dokumentacji; XLSX zestawień; JSON UTF-8 do importu; załączniki w oryginalnych formatach po odszyfrowaniu. Przy wielu miejscach pracy katalogi pacjentów grupowane są według miejsca pracy. JSON części ma postać: { "schemaVersion": 1, "encryption": "decrypted", "capturedAtUtc": "2026-11-19T12:00:00Z", "patientId": null, "collections": { "profile": {}, "sessions": [] } } patientId: UUID dla części pacjenta, null dla części konta. collections: nazwane kolekcje rekordów, pojedynczy rekord lub null. Brak kolekcji nie oznacza braku danych w innych częściach eksportu. Identyfikatory i klucze relacji zachowują wartości źródłowe; nie importuj ich jako uprawnień. Daty UTC zawierają Z; date to data kalendarzowa, timeStart to lokalna godzina wizyty, nie samodzielny znacznik UTC. Enumy są zapisane jako tekst. Null oznacza brak wartości. Nieznane pola należy zachować lub ignorować, a nie odrzucać całej kopii. 3. Kolekcje Kartoteka: patient, consents, customConsents, goalPhases, goals, symptoms, medications, labels, sessions, sessionNotes, notebooks, folders, notes, pages, pageRevisions, attachments, noteTags, tags, noteAudit, patientFiles, documents, conceptualizations, conceptualizationRevisions, conceptualizationExports, conceptualizationAudit, genograms, formShares, formSubmissions, formReminders, documentShares. Konto: profile, legalAcceptances, tags, patientLabels, workingHours, notificationSettings, consentTemplates, formTemplates, formReminders, noteTemplates, noteTemplatePages, noteTemplateAttachments, sessions, recurrenceSeries, organizationContacts, organizationWaitlist, organizationScheduleHistory. Dane prywatne obejmują także notifications, billingProfiles, organizations właściciela, subscriptions, payments, invoices, invoiceLines i documents bez pacjenta. organizationContacts.details: firstName, lastName, phone, email; patientId wiąże dane do umawiania z kartoteką, jeśli istnieje powiązanie. organizationId identyfikuje gabinet; therapistId właściciela kartoteki. Pola tekstowe nazwane historycznie *Encrypted mogą zawierać już odszyfrowaną wartość w pobranym ZIP. JSON nie jest formatem FHIR ani HL7. Nie deklarujemy zgodności ze standardem wymiany dokumentacji medycznej. 4. Otwarty interfejs eksportu Dokumentacja jest dostępna bez opłaty klientom i dostawcom docelowym. API działa pod adresem API właściwego środowiska OtterSafe (nie pod adresem strony marketingowej). Wymaga ważnego uwierzytelnienia konta; nie ma anonimowego dostępu do danych. Nie przekazuj innemu dostawcy swojego hasła. Dla integracji lub bezpiecznego przekazania kopii: kontakt@ottersafe.pl. POST /api/data-exports Content-Type: application/json; Authorization: Bearer { "patientId": null, "exportId": "", "replaceExisting": false, "workspaces": ["private", ""] } Pomiń patientId lub ustaw null dla konta; dla kartoteki podaj jej UUID. Dla konta podaj jawny zakres workspaces; brak oznacza bieżące miejsce pracy. Nie używaj replaceExisting bez zamiaru zastąpienia aktywnego eksportu. Odpowiedź 200: id, schemaVersion, capturedAtUtc, expiresAtUtc, parts, files. parts: id i patientId; files: id, patientId, entityId, noteId, encryptionContextId, kind, fileName, contentType, sizeBytes. GET /api/data-exports/{id}/parts/{partId} — JSON migawki. GET /api/data-exports/{id}/files/{fileId} — plik źródłowy migawki. DELETE /api/data-exports/{id} — zwolnienie migawki, odpowiedź 204. Migawka wygasa po 2 godzinach; można przygotować nową. Ten techniczny czas nie skraca umownego okresu na odzyskanie danych przy zmianie dostawcy. Brak lub wygasły zasób: 404; wymagane uwierzytelnienie: 401. Nie zakładaj, że API zwraca czytelne dane: warstwa E2EE pozostaje zaszyfrowana. Przeglądarka odblokowuje dane i tworzy opisany wyżej ZIP. Tymczasowy klucz organizationExportKey i envelopesJson służą tylko odszyfrowaniu przez właściciela, nie występują w gotowej kopii. Import do dostawcy docelowego najprościej oprzeć na gotowym ZIP/JSON. Wsparcie przy implementacji odszyfrowania udostępniamy w ramach uzasadnionej pomocy przy przeniesieniu. 5. Ograniczenia i kontrola Jedna aktywna operacja eksportu, plik ZIP poniżej 4 GiB i 65535 wpisów. Duże zasoby można dzielić według kartotek. Brak miejsca na urządzeniu, utrata klucza lub brak załącznika wymagają rozwiązania przed usunięciem źródła. Sprawdź raport braków; eksport z brakami nie jest pełną kopią. Kod aplikacji, klucze usługowe, hasła, tokeny uwierzytelniania i wewnętrzne logi infrastruktury nie są eksportem danych klienta. Nie deklarujemy automatycznego importu do każdego systemu ani zgodności z niezweryfikowanymi normami interoperacyjności. 6. Konfiguracja administracyjna gabinetu Na żądanie zweryfikowanego właściciela udostępniamy osobny JSON UTF-8, schemaVersion=1, kind=organization-configuration, capturedAtUtc. Zawiera organization, members, invitations (bez tokenów), rooms, roomBlocks, workingHours, absences i subscriptions (bez identyfikatorów płatniczych). organization.id łączy rekordy przez organizationId; roomBlocks.roomId wskazuje rooms.id, a therapistId wskazuje identyfikator użytkownika. Historyczne rekordy mogą wskazywać byłych członków. Godziny grafiku są lokalne. Eksport obejmuje dane nabywcy i konfigurację dostępu, nie nadaje dostępu w systemie docelowym. Nie obejmuje pacjentów, wizyt, dokumentacji klinicznej, prywatnego grafiku ani kluczy E2EE. Uprawnieni terapeuci eksportują swoje dane oddzielnie. Zamówienie i uzgodnienie zakresu: kontakt@ottersafe.pl.