VDX Device Registration Service — Implementeringsguide¶

Denne guide er til tredjeparts-systemer, der skal registrere, administrere og kommunikere med VDX-videoudstyr via VDX Device Registration Service.

API'et dækker tre ansvarsområder:

Device Admin — opret, opdater, slet og administrer enheder samt push møder/beskeder til enheder
Device Comm — enheder henter ventende møder og beskeder (polling)
Device Login — one-click login og auto-oprettelse af enheder via creation token

Adgang sker primært via OAuth2 access token fra VDX Keycloak. To login-endpoints er public (ingen Bearer token).

Hvem er guiden til?¶

Eksterne udviklere og leverandører af videoudstyr (fx SIP-endpoints, patient-skærme)
Teams der skal integrere device-lifecycle og push-baseret mødeinvitation
Organisationer med meeting-admin-adgang der skal provisionere enheder i VDX

Arkitektur — overblik¶

flowchart LR
    subgraph admin [Admin backend]
        AdminApp[Admin app]
    end
    subgraph device [Videoudstyr]
        DeviceClient[Device klient]
    end
    Keycloak[VDX Keycloak]
    DevRegAPI[Device Registration v1]

    AdminApp -->|OAuth2 meeting-admin| Keycloak
    AdminApp -->|CRUD devices, push meetings| DevRegAPI
    DeviceClient -->|OAuth2 device token| Keycloak
    DeviceClient -->|Poll meeting/message| DevRegAPI
    AdminApp -->|One-click link| DeviceClient
    DeviceClient -->|Public login| DevRegAPI

Indholdsfortegnelse¶

Integrationsguide og support¶

Side	Beskrivelse
Integrationsguide	Kom i gang, autentificering, device-lifecycle, meeting/message-kø og best practices
Support	Kontakt, fejlrapportering og OpenAPI-kontrakt

API-reference¶

Sektion	Beskrivelse
Endpoints	Base URLs, headers og alle 16 endpoints grupperet efter Device Admin / Comm / Login
Modeller	Request/response-modeller (device, meeting, message, login)
Kodeeksempler	curl-eksempler for device CRUD, meeting-flow og login-flow

Anbefalet læserækkefølge¶

Integrationsguide — start med Kom i gang og Autentificering
Device-lifecycle → POST /v1/device
Meeting-kø-flow → POST /v1/meetings og GET /v1/meeting
Kodeeksempler — praktiske curl-kald

Ændringshistorik¶

Dato	Ændring
2026-06-27	Første version af VDX Device Registration Service integrationsguide i mkdocs_webapp