Opptak

Liste opptak

GET /api/v1/recordings

Returnerer en paginert liste over opptak som er tilgjengelige for den autentiserte brukeren.

Spørringsparametere

Parameter	Type	Standard	Beskrivelse
`limit`	number	`20`	Antall resultater (1–100)
`offset`	number	`0`	Pagineringsofffset
`search`	string	-	Filtrer etter tittel (delvis samsvar)
`status`	string	-	Filtrer etter status (se Opptaksstatuser)
`date_from`	string	-	ISO 8601-dato, returnerer kun opptak opprettet på eller etter
`date_to`	string	-	ISO 8601-dato, returnerer kun opptak opprettet på eller før
`organization_id`	string	-	Avgrens til en organisasjon
`folder_id`	string	-	Avgrens til en mappe (krever `organization_id`)

Respons

{
  "data": [
    {
      "id": "uuid",
      "status": "COMPLETED",
      "title": "Weekly sync",
      "createdAt": "2025-09-19T15:00:00.000Z",
      "thumbnailUrl": "https://...",
      "progress": 1.0,
      "capabilities": {
        "canDownload": true,
        "canShare": true,
        "canViewTranscription": true,
        "canGenerateSummary": true,
        "canAskQuestions": true
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}

Hent opptak

GET /api/v1/recordings/:id

Returnerer fullstendige detaljer for et enkelt opptak.

Organisasjonsopptak er tilgjengelige for alle organisasjonsmedlemmer som har tillatelse til å se dem. Eiere og administratorer kan åpne alle opptak i organisasjonen sin; redaktører og seere ser opptakene rollen og mappetilgangen deres tillater. For et organisasjonsopptak reflekterer is_locked, download_url og capabilities organisasjonens plan og medlemmets funksjonsflagg, ikke innringerens personlige plan.

Returnerer 402 ORGANIZATION_SUBSCRIPTION_EXPIRED når organisasjonens Enterprise-abonnement ikke lenger er aktivt.

Respons

{
  "data": {
    "id": "uuid",
    "status": "COMPLETED",
    "title": "Weekly sync",
    "createdAt": "2025-09-19T15:00:00.000Z",
    "updatedAt": "2025-09-19T15:30:00.000Z",
    "startedAt": "2025-09-19T15:01:00.000Z",
    "endedAt": "2025-09-19T15:30:00.000Z",
    "videoUrl": "https://...",
    "hlsUrl": "https://...",
    "downloadUrl": "https://...",
    "downloadUrlExpiresAt": "2025-09-19T21:00:00.000Z",
    "thumbnailUrl": "https://...",
    "organizationId": "org_uuid or null",
    "transcription": {
      "status": "completed",
      "language": "en",
      "speakers": ["Speaker 1", "Speaker 2"],
      "segmentsCount": 184,
      "duration": 1740.5
    },
    "summary": {
      "status": "completed",
      "content": "## Key topics\n...",
      "topics": [
        {
          "title": "Project timeline",
          "keyPoints": [
            { "point": "Launch date confirmed", "details": ["Set for Q1"] }
          ]
        }
      ]
    },
    "isLocked": false,
    "capabilities": {
      "canDownload": true,
      "canShare": true,
      "canViewTranscription": true,
      "canStartTranscription": true,
      "canRegenerateTranscription": false,
      "canRenameSpeaker": true,
      "canViewSummary": true,
      "canGenerateSummary": true,
      "canAskQuestions": true
    }
  }
}

Hent transkripsjonssegmenter

GET /api/v1/recordings/:id/transcript

Returnerer paginerte transkripsjonssegmenter for et opptak.

Organisasjonsopptak følger de samme tilgangsreglene som Hent opptak. Returnerer 403 RECORDING_LOCKED når opptaket er låst og 403 TRANSCRIPT_NOT_AVAILABLE når transkripsjon er deaktivert for organisasjonen eller medlemmet. Et opptak som ennå ikke er transkribert, returnerer fortsatt 200 med "status": "not_started" og en tom segments-array.

Spørringsparametere

Parameter	Type	Standard	Beskrivelse
`start_chunk`	number	`0`	Indeks for blokk å starte fra
`limit`	number	`50`	Antall blokker (1–100)

Respons

{
  "data": {
    "status": "completed",
    "language": "en",
    "speakers": ["Speaker 1", "Alice"],
    "duration": 1740.5,
    "segments": [
      {
        "id": 1,
        "start": 0.5,
        "end": 3.2,
        "text": "Good morning everyone.",
        "speaker": "Alice",
        "confidence": 0.97
      }
    ],
    "pagination": {
      "total_chunks": 184,
      "has_more": true
    }
  }
}

Oppdater opptak

PATCH /api/v1/recordings/:id

Oppdater tittel eller notater for et opptak. Minst ett felt er påkrevd.

Forespørselsorgan

{
  "title": "New title (1–500 characters)",
  "notes": "Optional notes (max 100,000 characters)"
}

Respons

{
  "data": { "success": true }
}

Slett opptak

DELETE /api/v1/recordings/:id

Sletter et opptak og alle tilknyttede data (transkripsjon, sammendrag, delinger) permanent.

Respons

{
  "data": { "success": true }
}

Opprett delingslenke

POST /api/v1/recordings/:id/share-link

Genererer en offentlig delingslenke for opptaket.

For et organisasjonsopptak kan ethvert medlem som kan se opptaket, opprette lenken. Lenken opprettes på vegne av opptakets eier og bruker organisasjonens plan, slik at download-lenker fungerer for organisasjonsopptak selv når innringerens personlige plan er gratis. Returnerer 403 RECORDING_LOCKED når opptaket er låst og 403 SHARING_DISABLED når deling er deaktivert for organisasjonen eller medlemmet.

Forespørselsorgan

{
  "permission": "view"
}

Verdi	Beskrivelse
`view`	Mottakere kan se videoen og få tilgang til transkripsjonen/sammendraget
`download`	Mottakere kan også laste ned videofilen

Respons

{
  "data": {
    "share_url": "https://recordmeeting.com/app/shared/abc123",
    "share_token": "abc123",
    "permission": "view"
  }
}

Opptaksstatuser

Status	Beskrivelse
`STARTING`	Opptaksforespørsel mottatt, oppsett pågår
`CONNECTING`	Kobler til Google Meet-sesjonen
`WAIT_APPROVAL`	Venter på godkjenning i samtale for å starte opptak
`RECORDING`	Tar aktivt opp
`UPLOADING`	Klient-side opplasting pågår (biter tømmes til lagring)
`PROCESSING`	Cloudflare Stream pakker HLS/DASH, kan ennå ikke spilles av
`MIGRATING`	Video fullt avspillbar, HLS migreres til langtidslagring
`COMPLETED`	Opptak fullt behandlet og lagret
`ERROR`	Opptak mislyktes

API-forbrukere bør behandle MIGRATING identisk med COMPLETED for avspilling, nedlasting og deling. Skillet er internt.