MedCom Video API — Implementeringsguide¶

Denne guide er til tredjeparts-systemer, der skal planlægge, oprette, opdatere og administrere videomøder via MedCom Video API (VDX Booking Module API).

API'et håndterer mødebooking, scheduling templates og pool-reservationer. Kald API'et med en OAuth2 access token fra VDX Keycloak, der indeholder de påkrævede bruger-claims og roller.

Foretrækker du alt på én side? Se single-page versionen — komprimeret med de vigtigste eksempler.

Bemærk: Brug v2 som primær API-version. v1 er under udfasning — se v1/v2-forskelle.

Hvem er guiden til?¶

Eksterne udviklere og leverandører uden adgang til VDX-kodebasen
Teams der skal integrere mødebooking eller mødeadministration mod VDX

Arkitektur — overblik¶

flowchart LR
    subgraph client [Din app]
        Backend[Backend / klient]
    end
    Keycloak[VDX Keycloak]
    VideoAPI[MedCom Video API v2]

    Backend -->|OAuth2 Bearer token| Keycloak
    Backend -->|"POST /v2/meetings"| VideoAPI
    Backend -->|"GET /v2/scheduling-info/{uuid}"| VideoAPI
    Backend -->|"GET /v2/scheduling-templates"| VideoAPI

Indholdsfortegnelse¶

Integrationsguide og reference¶

Side	Beskrivelse
Integrationsguide	Kom i gang, autentificering, roller, integrationsmønstre og anbefalede flows
Reference	Fejlkoder, JWT-claims, timestamp-format og v1/v2-forskelle
Support	Kontakt og fejlrapportering

API-reference¶

Sektion	Beskrivelse
Endpoints	Base URLs, headers og endpoint-oversigt (v2)
Modeller	Request/response-modeller (DTO'er)
Kodeeksempler	curl og JSON for centrale scenarier

Anbefalet læserækkefølge¶

Integrationsguide — start med Kom i gang, Autentificering og Roller og adgang
Opret møde-flow → POST /v2/meetings → Meeting-modellen
Kodeeksempler — praktiske curl-kald
OpenAPI-kontrakt på SwaggerHub for fuld felt-reference

Ændringshistorik¶

Dato	Ændring
2026-06-27	Første version af MedCom Video API integrationsguide i mkdocs_webapp