Enkel-TV
API for
innholdsleverandører

3Tilgang, rettigheter og feil

Leverandøren får en API-nøkkel av Enkel-TV. Hver nøkkel tilhører en leverandør og har et sett rettigheter som krysses av når nøkkelen lages. En leverandør kan ha flere nøkler, f.eks. én per ansatt eller per system; alt innhold tilhører leverandøren, ikke nøkkelen. Serveren kjenner igjen nøkkelen på en SHA-256-sjekksum, og nøkkelen vises som regel bare én gang, når den lages – ta vare på den. Er den borte eller kommet på avveie, lager Enkel-TV en ny og trekker tilbake den gamle, som da slutter å virke med en gang (401). Innholdet leverandøren har laget, blir liggende.

Authorization: Bearer etv_VUFK…        # nøkkelen begynner alltid med etv_
Content-Type: application/json         # eller application/zip for lysbildepakker

Hvilken leverandør en profil (TV) har, velger Enkel-TV. GET /api/publish/profiles viser profilene nøkkelen har tilgang til. En tom liste betyr at ingen profiler er koblet til leverandøren ennå – be Enkel-TV velge leverandøren på TV-ene det gjelder.

Rettighetene

«Egne profiler» er aktive profiler der nøkkelens leverandør er valgt som leverandør. En profil som ikke er leverandørens, finnes ikke for nøkkelen (404 no-profile), bortsett fra lesing med events:all.

Bio, notater og bilder kan bare leses for egne profiler – også med events:all. En vanlig nøkkel for en ekstern leverandør har library:write, lineups:write og events:read, og profiles:read og photos:read når leverandøren skal bruke bio, notater og bilder.

Svar og feil

Alle svar er JSON med status 200, også når noe lagres. Feil har en HTTP-status og en kropp med error – en melding på norsk – og som regel en fast code. Meldingen er til mennesker og kan bli bedre formulert; programmer skal se på status og code. Valideringsfeil begynner med stien til feltet som er feil:

HTTP/1.1 400 Bad Request
{ "error": "items[3].youtube.videoId må være en YouTube-ID på 11 tegn", "code": "invalid-playlist" }

Dette er alle feilene /api/publish kan gi:

Feil uten code (401, 404 for ukjent adresse, 405 og 500) har bare error. Innholds-API-et har ingen grense for antall kall (kap. 19). Bak en proxy kan en omstart av serveren gi 502 eller 503 i noen sekunder – prøv igjen.

5Spillelister og de tre innslagstypene

En spilleliste er innslag i rekkefølge, og de tre typene – YouTube NRK Lysbilder – kan blandes fritt. Spillelister lagres med PUT /api/publish/playlists/{id}; svaret er { "id", "version", "changed", "items" }, der items er antall innslag. En spilleliste vises først på TV-en når den er publisert til en kanal (kap. 9).

Format enkeltv-playlist/1

Oversikt: de tre innslagstypene

Hvert innslag har noen felles felt og ett objekt med typens egne felt. Objektet har samme navn som kind: et YouTube-innslag har "kind": "youtube" og objektet "youtube": { … }. Et objekt for en annen type gir feil. * = påkrevd; alt annet er valgfritt.

GET /api/publish/playlists/{id} viser alltid seriens nåværende lengde som duration på lysbildeinnslag. playUrl og format i nrk-objektet fra eldre dokumenter brukes ikke: de ignoreres og fjernes når spillelisten lagres.

Eksempel: en spilleliste med alle tre typene

PUT /api/publish/playlists/enkeltv.ingrid-kveld-uke41
{
  "format": "enkeltv-playlist/1",
  "title": "Ingrid – kveld, uke 41",
  "visibility": "personal",
  "profile": "p_7Kq2mPx9Qa",
  "items": [
    { "id": "yt.bergensbanen", "kind": "youtube", "title": "Bergensbanen",
      "duration": 1800, "tags": ["tog", "vinter"],
      "youtube": { "videoId": "d_S_13TWn1c", "start": 14400 } },

    { "id": "lysbilder.bergen-1950", "kind": "slideshow", "title": "Bergen på 1950-tallet",
      "tags": ["bergen", "hjemsted"],
      "slideshow": { "ref": "enkeltv.ingrid-bergen-1950" } },

    { "id": "yt.ZlGyCfigmFg", "kind": "youtube", "title": "Allsang: Liten fuggel",
      "duration": 208, "tags": ["allsang"],
      "youtube": { "videoId": "ZlGyCfigmFg" } },

    { "id": "nrk.fleksnes.s1e1", "kind": "nrk", "title": "Fleksnes",
      "duration": 2196, "tags": ["humor", "70-tallet"],
      "availableFrom": "2026-10-01", "availableTo": "2026-12-31",
      "nrk": { "nrkId": "FUHA01005272", "type": "episode",
               "seriesTitle": "Fleksnes", "season": 1, "episode": 1, "year": 1972 } }
  ]
}

6Lysbildeserier

En lysbildeserie beskriver skjermbilder med lag – bilde, video, tekst og form – plassert fritt på et 16:9-lerret, med lyd og musikk på faste tider. TV-en tegner nøyaktig det JSON-en beskriver. Leverandøren kan dermed bygge rike skjermbilder uten å sende kode. Serien lagres med PUT /api/publish/slideshows/{id}, enten som zip-pakke med filene (kap. 7) eller som ren JSON når alle filene er https://- eller sha256:-adresser.

Lerretet

• x og y er øvre venstre hjørne, w og h bredde og høyde – alle i prosent av lerretet (0–100).
• Tekststørrelse (size) er prosent av lerretets høyde: 6 er omtrent 65 piksler på en full-HD-TV. For eldre seere anbefaler vi minst 4,5 for hovedtekst.
• Lagene tegnes i rekkefølge: senere lag ligger oppå tidligere.
• Tider (start, end, fadeIn, fadeOut) er sekunder fra lysbildet begynner, med desimaler. Er fadeIn + fadeOut lengre enn tiden laget vises, krympes begge forholdsmessig.
• Kreditering (credit) vises lite og alltid nede til høyre.

7Lysbildepakker (zip)

En hel lysbildeserie kan sendes som én zip-fil: manifest.json med serien, og mediefilene den peker på. Serveren sjekker pakken, lagrer filene og gir serien en versjon. Etterpå kan serien brukes i så mange spillelister man vil, bare ved å peke på ID-en – uten ny opplasting.

enkeltv.bergen-1950.zip
├── manifest.json                 ← lysbildeserien (enkeltv-slideshow/1)
└── media/
    ├── floyen-1961.jpg
    ├── torget-1954.jpg
    ├── bryggen-1958.mp4
    ├── tale/floyen.mp3
    ├── tale/torget.mp3
    ├── musikk/morgenstemning.mp3
    └── gammel-utgave.jpg         ← ikke brukt: gir en advarsel

Krav til pakken

• manifest.json ligger i roten av zip-filen (rekkefølgen i pakken spiller ingen rolle), er gyldig JSON i UTF-8 og høyst 1 MB. Filene manifestet peker på, ligger under media/, og stiene i manifestet er relative til roten. Er selve mappen pakket (mappe/manifest.json), sier feilen «pakk innholdet i mappen, ikke selve mappen».
• Vanlig zip: lagret (metode 0) eller deflate (metode 8). Ikke kryptering, ikke ZIP64 (pakken må være under 4 GB og ha færre enn 65 535 filer), ikke delt over flere filer, og høyst 20 000 filer. Pakker fra verktøy som strømmer zip (med «data descriptor») går fint.
• Stiene må være relative og rene: ingen / først, ingen stasjonsbokstav, ingen .. eller \, ingen tomme ledd eller .-ledd, og ingen symbolske lenker. Samme sti kan ikke finnes to ganger.
• Hver fil sjekkes mot størrelsen og CRC-32 i pakken mens den pakkes ut.
• Alle filer manifestet peker på, må finnes, og stiene må stemme nøyaktig – også store og små bokstaver. Finnes det en fil som bare skiller seg i store og små bokstaver, foreslår feilmeldingen den («mente du media/Torget.JPG?»).
• Filer ingen peker på, ignoreres, med en advarsel i warnings. Filer som Mac og Windows legger i pakken av seg selv (__MACOSX/, ._-filer, .DS_Store, Thumbs.db og desktop.ini), gir ingen advarsel.
• Filnavn med æøå virker fra Mac og fra Windows (Utforsker og 7-Zip). Bruk likevel helst a–z, 0–9, - og _ i filnavnene.
• Serveren kjenner igjen filtypen på innholdet, ikke på filnavnet, og konverterer ingenting – filene må leveres i et format TV-en kan spille. En fil med ukjent filtype gir 400 invalid-slideshow med stien til feltet og filen.
• ID-en, leverandøren og eierskapet sjekkes før pakken tas imot (400 invalid-slideshow, 403 no-provider, 409 id-taken), så svaret kan komme før hele pakken er sendt.

HEIC-, HEIF- og AVIF-bilder (vanlig fra iPhone) er ukjent filtype og må gjøres om til JPEG før de legges i pakken. MOV og 3GP godtas, men serveren sjekker ikke kodeken i klippet: H.264 virker, mens HEVC (H.265), som iPhone tar opp med som standard, kan TV-en ikke spille sikkert. Gjør derfor helst videoen om til MP4 med H.264 og AAC.

Grenser

• 200 MB per serie. Zip-pakken kan være høyst 200 MB, og summen av alle filene serien bruker – nye filer, filer fra før og sha256:-filer – kan være høyst 200 MB. Ellers 413 too-large, f.eks. Serien bruker 212 MB – grensen er 200 MB.
• Ingen lagringskvote per leverandør. Filer som brukes av flere serier, lagres én gang.
• Serien sendt som ren JSON kan være høyst 1 MB.
• Opplastingen må bli ferdig innen 30 minutter. 200 MB krever da omtrent 1 Mbit/s opp. På en treg linje: del serien i flere pakker, eller send bare nye filer – sjekk først hvilke serveren har med POST /media/check, og pek på resten som sha256:….

Laste opp og gjenbruke

PUT /api/publish/slideshows/enkeltv.bergen-1950
Content-Type: application/zip
<zip-filen>

HTTP/1.1 200 OK
{ "id": "enkeltv.bergen-1950", "version": 1, "changed": true, "duration": 36, "slides": 3,
  "bytes": 48213377, "media": { "new": 6, "reused": 0 },
  "warnings": [ "media/gammel-utgave.jpg er ikke brukt i manifestet" ] }

• Svaret. duration er seriens lengde i sekunder, bytes summen av filene serien bruker, og media hvor mange filer som var nye og hvor mange serveren hadde fra før.
• Finnes serien allerede? GET /api/publish/slideshows/{id} gir det lagrede dokumentet med versjon, lengde og størrelse (eller 404). Da holder det å peke på den i spillelisten: "slideshow": { "ref": "enkeltv.bergen-1950" }.
• Versjoner. Ny opplasting med samme ID og endret innhold gir ny versjon. En identisk opplasting gir "changed": false, samme versjon og "media": { "new": 0, "reused": N }. Spillelister peker alltid på gjeldende versjon; TV-en får den ved neste programskifte (kap. 11).
• Bare JSON. En serie der alle filer er https:// eller sha256:, kan sendes som application/json uten zip. media/-stier er bare lov i zip-pakker.
• Ikke send filer på nytt. POST /api/publish/media/check med en liste med høyst 1000 sha256-summer svarer hvilke filer serveren har. Manifestet kan peke på dem som sha256:…, så pakken bare trenger de nye filene.

POST /api/publish/media/check
{ "sha256": [ "e1e5628ba30deef1d0a0e5c38e6d6b74aa32a21da631f7159a9b7ca78f02dbe6",
              "23193579fb505275fb6ddd64b1e62e36d26db474958cda9c1c9659d6cb62be26" ] }

{ "have": [ "e1e5628ba30deef1d0a0e5c38e6d6b74aa32a21da631f7159a9b7ca78f02dbe6" ],
  "missing": [ "23193579fb505275fb6ddd64b1e62e36d26db474958cda9c1c9659d6cb62be26" ] }

8Mediefiler

Bilder, lyd og video fra lysbildepakkene – og familiebildene fra mobilappen – ligger i serverens mediearkiv.

• Innholdsadressert. Hver fil lagres én gang, under sin sha256-sum. Samme fil i mange serier tar plass én gang, og en fil som lastes opp på nytt, kjennes igjen.
• Signerte adresser. Alle filer leveres som /media/<sha256>.<filtype>?e=<utløp>&s=<signatur>, og bare med gyldig signatur (HMAC-SHA256 med en hemmelighet som bare serveren har). Ugyldig eller utløpt adresse gir 403. Adressene kan ikke gjettes ut fra sha256-summen.
• Hvor lenge. Adressene TV-en får i lysbildeseriene, gjelder til slutten av neste døgn (UTC), så de er like hele dagen. TV-en henter nye ved midnatt UTC. Adressene til familiebilder gjelder i minst 15 minutter (utløpet rundes opp til nærmeste 10 minutter).
• Levering. GET og HEAD, riktig Content-Type, ETag (sha256-summen), Cache-Control: private, max-age=86400 og støtte for Range (ett område per forespørsel; 206, eller 416 for et ugyldig område; flere områder gir hele filen) og If-None-Match (304), så video og lyd kan spoles.
• Opprydding. En fil slettes når verken en lysbildeserie eller et familiebilde bruker den lenger.
• Familiebilder kan bare brukes i en personlig lysbildeserie for den samme profilen. En leverandør med photos:read og samtykke får bildets sha256 og kan bruke det som "src": "sha256:…"; i en felles serie eller en serie for en annen profil avvises det: … er et familiebilde og kan bare brukes i personlige serier for samme profil. Det gjelder også etter at familien har slettet bildet.
• Slettede familiebilder. Sletter familien eller personalet et bilde som brukes i en personlig serie, blir det stående i serien til leverandøren endrer eller sletter serien. Hent /photos jevnlig, og fjern bilder som er borte derfra, fra seriene.
• Leverandørens egne filer kan ikke lastes ned igjen gjennom innholds-API-et. GET /api/publish/slideshows/{id} viser filene som sha256:… eller den opprinnelige https-adressen.

10Kanaloppsett per profil

Kanaloppsettet bestemmer hva beboeren finner når hen blar med pil opp/ned. Det har et antall kanaler (channelCount, 1–99) og en kanal for plassene profilen har valgt selv. Fjernkontrollen går rundt: 0 → 1 → … → channelCount → 0, og 0 er alltid klokkeskjermen. Har profilen ikke et eget antall, gjelder standardoppsettets (10 hvis standardoppsettet ikke har et antall).

Hva vises på en plass?

For hver plass fra 1 til channelCount velger serveren den første kilden som har innhold i dagens sendedøgn:

«Har innhold» betyr at kanalen finnes, at programmeringen har en spilleliste for dagens sendedøgn (kap. 9), og at spillelisten har minst ett innslag som er tilgjengelig denne datoen. Lysbildeinnslag der serien er slettet, regnes ikke med. En direktekanal (kap. 9) har alltid innhold. En kanal uten innhold i dag gjør at plassen faller videre til neste kilde.

Format enkeltv-lineup/1

Kanalen må finnes og være felles eller personlig for denne profilen – ellers 400 invalid-lineup, f.eks. slots.3 viser til kanalen «x», som ikke finnes. En felles kanal kan være laget av hvilken som helst leverandør.

Svaret

PATCH /api/publish/profiles/p_7Kq2mPx9Qa/lineup        (endrer bare plassene som er nevnt)
{ "slots": { "7": "kysten", "8": { "channel": "allsang", "name": "Sangstund" }, "15": null } }

GET /api/publish/profiles/p_7Kq2mPx9Qa/lineup
{
  "format": "enkeltv-lineup/1",
  "profile": "p_7Kq2mPx9Qa",
  "channelCount": 15,
  "ownChannelCount": 15,
  "slots": {
    "6": "enkeltv.ingrids-kanal",
    "7": "kysten",
    "8": { "channel": "allsang", "name": "Sangstund" },
    "14": "gammeldans"
  },
  "resolved": [
    {"slot": 1, "channelId": "nrk1", "name": "NRK1", "source": "default"},
    {"slot": 2, "channelId": "nrk2", "name": "NRK2", "source": "default"},
    {"slot": 3, "channelId": "nrk3", "name": "NRK3", "source": "default"},
    {"slot": 4, "channelId": "sporet", "name": "Sporet", "source": "default"},
    {"slot": 5, "channelId": "fjell-og-fjord", "name": "Fjell og fjord", "source": "default"},
    {"slot": 6, "channelId": "enkeltv.ingrids-kanal", "name": "Ingrids kanal", "source": "profile"},
    {"slot": 7, "channelId": "kysten", "name": "Kysten", "source": "profile"},
    {"slot": 8, "channelId": "allsang", "name": "Sangstund", "source": "profile"},
    {"slot": 9, "channelId": "norge-for-i-tiden", "name": "Norge før i tiden", "source": "default"},
    {"slot": 10, "channelId": "klassisk", "name": "Klassisk", "source": "default"},
    {"slot": 11, "channelId": "dyr-og-fugler", "name": "Dyr og fugler", "source": "default"},
    {"slot": 12, "channelId": "bilder-fra-bergen", "name": "Bilder fra Bergen", "source": "default"},
    {"slot": 13, "channelId": "nrk", "name": "NRK-arkivet", "source": "default"},
    {"slot": 14, "channelId": "gammeldans", "name": "Gammeldans", "source": "profile"},
    {"slot": 15, "channelId": "sporet", "name": "Sporet", "source": "fallback"}
  ],
  "updatedAt": "2026-10-05T08:12:00.000Z",
  "updatedBy": { "type": "provider", "name": "Enkel-TV" }
}

Hvem endrer oppsettet?

• Leverandøren til profilen, med lineups:write: PUT erstatter hele oppsettet, PATCH endrer bare plassene og feltene som er med.
• Personalet i Enkel-TV, i sitt eget verktøy (admin): antall kanaler, kanal på hver plass og eget navn.

Den siste lagringen gjelder. Hver endring lagrer hvem som gjorde den, og gir hendelsen lineup.changed med plassene som ble endret (kap. 13). En lagring som ikke endrer noe, gir ingen hendelse.

Standardoppsett og reserveprogram

Standardoppsettet har samme format, pluss fallback (reserveprogrammet: en felles kanal-ID eller null). Det kan bare inneholde felles kanaler, leses med alle nøkler og endres med PUT og rettigheten lineups:default. channelCount gjelder profiler som ikke har satt sitt eget antall; utelates det i PUT, blir det 10. Plasser med null hoppes over, og en plass kan ha eget navn ({ "channel", "name" }) som i profilens oppsett – men fallback må være en ren kanal-ID.

Svaret på GET og PUT har feltene format, channelCount, slots, fallback, updatedAt og updatedBy. Er standardoppsettet aldri lagret, er det { "format": "enkeltv-lineup/1", "channelCount": 10, "slots": {}, "fallback": null, "updatedAt": null, "updatedBy": null }.

PUT /api/publish/lineups/default
{
  "format": "enkeltv-lineup/1",
  "channelCount": 13,
  "slots": { "1": "nrk1", "2": "nrk2", "3": "nrk3", "4": "sporet", "5": "fjell-og-fjord",
             "6": "kysten", "7": "gamle-slagere", "8": "gammeldans", "9": "norge-for-i-tiden",
             "10": "klassisk", "11": "dyr-og-fugler", "12": "bilder-fra-bergen", "13": "nrk" },
  "fallback": "sporet"
}

Med dette standardoppsettet får alle profiler direktekanalene NRK1–3 (kap. 9) på plass 1–3, med mindre profilen har lagt egne kanaler på de plassene. Standardoppsettet endres bare av Enkel-TVs egen innholdstjeneste (lineups:default).

11Lineær TV: tidslinjen

Hver kanal har én tidslinje som går hele tiden, også når ingen ser på. Tidslinjen er ren regning uten lagret tilstand: serveren og TV-en bruker den samme regnemåten og kommer alltid fram til det samme. Alle profiler som har samme felles kanal, ser derfor det samme samtidig. En personlig kanal har bare én seer. Direktekanaler (kap. 9) har ingen tidslinje: de viser NRK-sendingen slik den går.

Sendedøgnet og regnestykket

Sendedøgnet med dato D begynner D kl. 06:00 og slutter D+1 kl. 06:00, norsk tid (Europe/Oslo). Mellom midnatt og kl. 06:00 hører natten til gårsdagens sendedøgn. Starttidspunktet regnes ut med tidssonen, så døgnet er 25 timer når klokka stilles tilbake om høsten (sendedøgnet lørdag 24. oktober 2026 varer til søndag kl. 06:00 vintertid) og 23 timer når den stilles fram om våren (sendedøgnet lørdag 27. mars 2027).

dagStart = D kl. 06:00 norsk tid (som UTC-tidspunkt)          dagSlutt = D+1 kl. 06:00
L        = summen av duration for dagens innslag (sekunder)
runde    = gulv((t − dagStart) / L)                          t = tidspunktet vi spør om
pos      = t − dagStart − runde · L                          hvor langt inn i løkkerunden
innslag  = det første innslaget som slutter etter pos        offset = pos − innslagets start

• Rekkefølge. Innslagene går i rekkefølge fra kl. 06:00 og begynner forfra når lista er ferdig. Innslaget som går kl. 06:00 neste morgen, avbrytes – da begynner neste sendedøgn med sin spilleliste fra første innslag.
• Lengden styrer. duration bestemmer tidslinjen, ikke når mediet faktisk slutter. For lysbildeinnslag er lengden alltid seriens lengde (summen av lysbildene).
• Dagens spilleliste velges etter from/to i kanalens programmering, for sendedøgnets dato (kap. 9).
• Tilgjengelighet. availableFrom og availableTo på et innslag er også sendedøgn. Utenfor vinduet er innslaget ikke med i dagens liste, og resten av lista rykker sammen. Et innslag som er med, er med hele sendedøgnet.
• Klokka. Serveren har fasiten. TV-en måler avviket mot serverTime i hver polling og bruker serverens tid. En måling brukes bare når pollingen tok høyst 3 s; ellers beholdes forrige avvik.

Leverandøren ser resultatet med GET /api/publish/channels/{id}/schedule?date=YYYY-MM-DD – alle innslag i sendedøgnet, runde for runde (kap. 16).

Når endringer når TV-en

TV-en spør serveren hvert 2. sekund om noe er endret. Endres noe i biblioteket, standardoppsettet eller profilens kanaloppsett, henter TV-en kanalene på nytt – en endring når altså TV-en innen omtrent 2 sekunder. Det samme skjer når et nytt sendedøgn begynner, og ved midnatt UTC (da fornyes adressene til mediefilene, kap. 8). Er TV-en på en kanal, gjør den så dette:

Samtaler

Når en pårørende ringer, fryser TV-en avspillingen der den står – YouTube, NRK og lysbilder, med lyd, video og animasjoner – fra det begynner å ringe til TV-en er tilbake fra samtaleskjermen. Etterpå fortsetter innslaget akkurat der det stoppet. Kanalen ligger da like mye etter direkte som pausen varte, og neste innslag starter tilsvarende senere; klokkeslettene i banneret er forskjøvet like mye. Bytter man kanal, er man tilbake på direkte og forsinkelsen er borte. Fjernkontrollen bytter ikke kanal mens samtalen pågår. Pausen gir hendelsene playback.paused og playback.resumed (med pausedSeconds).

Når man kommer inn på en kanal

TV-en starter innslaget som går nå, så langt inn som sendingen har kommet (offset). Innhopp mindre enn 2 sekunder etter starten regnes som fra start (joined: start), ellers joined: middle.

12Slik spiller TV-en av

TV-appen logger inn med brukernavn og boks-ID og starter på klokkeskjermen (plass 0). Den henter profilens kanaler og dagens spillelister fra serveren, og kanalvelgeren eier tiden: den finner innslaget som går, starter riktig avspiller midt i det, planlegger slutten og går videre. Avspillerne bytter aldri innslag selv.

• Kanalbanneret vises i 4 sekunder når man bytter kanal og når TV-en kommer tilbake etter en samtale: plassnummer, kanalnavn, beskrivelse, «Nå: …» og «Neste kl. 19:30: …». Ved hvert programskifte vises det samme banneret i 3 sekunder. Plass 0 heter «Klokken».
• Pausebilde og «Kommer snart». Rolige, innebygde skjermbilder med kanalnummer og klokke (pausebildet også med kanalnavn) – aldri en svart skjerm eller en feilmelding. Pausebildet viser «Neste kl. …» eller «Programmet fortsetter snart.»; «Kommer snart» viser «Her kommer det snart noe fint å se på.».
• Lyd. Nettlesere spiller ofte ikke av lyd før noen har trykket på noe. Da spiller TV-en uten lyd i stedet for å stå med svart skjerm, viser «Trykk på en knapp for å få lyd» og melder sound.muted. Første tastetrykk slår på lyden i alle avspillere, også <video>, og gir sound.unlocked.
• Fjernkontrollen. Pil opp/ned (også kanal opp/ned og Page Up/Down) bytter kanal og går rundt. Alle tastetrykk registreres som remote.pressed (opp, ned eller annet), også under samtaler – men ikke gjentak når en tast holdes inne, eller trykk sammen med Alt, Ctrl eller Cmd.
• Ingen mellomlagring. TV-en lagrer ikke innhold og trenger nett for å spille av. Nettleserens vanlige cache brukes som normalt. Mister boksen nettet, viser klokkeskjermen «Ingen forbindelse».
• Omlasting. TV-en laster seg selv på nytt når ny programvare er lagt ut på serveren, og én gang i døgnet mellom kl. 03 og 05, men bare når ingen samtale pågår. Etterpå stiller den inn den samme kanalen igjen. I hendelsene ses det som channel.left med reason: off, tv.started og channel.entered med via: startup på samme plass.

TV-en og appene bruker egne, interne endepunkter som ikke er en del av leverandør-API-et (kap. 18).

Når noe ikke kan spilles

Serveren tar aldri innslag ut av tidslinjen av seg selv. TV-en viser noe rolig – aldri en svart skjerm eller en feilmelding – melder feilen som playback.error (kap. 13), og tidslinjen går videre som før. Feil som kan gå over av seg selv, prøver TV-en igjen, på riktig sted i tidslinjen:

details i playback.error kan være stalled (avspillingen sto stille: NRK 45 s, YouTube 60 s), «Får ikke kontakt med NRK (nett eller CORS): …», «NRK svarte ikke» (NRK svarte ikke innen 15 s), feilkoden fra hls.js eller beskjeden fra NRK.

14Profilen: bio, notater og bilder

Godt innhold for en person med demens tar utgangspunkt i livet personen har levd. Leverandøren intervjuer de pårørende utenfor systemet. I systemet bygges profilen opp av personalet og familien, og leverandøren kan lese den – bare når eieren av boksen har samtykket.

15Personvern

• Pseudonym. Leverandører ser profilen bare som ref: p_ og 10 tilfeldige tegn. Koblingen til personen finnes bare på serveren. ref endres ikke når boksen byttes.
• Samtykke fra eieren per kategori – bio, notater og bilder – og bare for profilens leverandør. Nytt samtykke kreves når leverandøren byttes.
• Familien velger for hvert notat og bilde om det kan gå til leverandøren eller bare til personalet.
• Andre personer på bilder. Den som laster opp, bekrefter i appen at de som er med på bildet, er enige.
• Dataminimering. Hendelsene har ingen fritekst fra brukerne. Tastetrykk registreres bare som opp, ned eller annet. Mobilappen fjerner posisjon og kamerainformasjon fra bildene.
• Revisjonslogg. Hver gang en leverandør henter bio, notater eller bilder, logges det. Endringer personalet gjør i bio, kanaloppsett, leverandør og bidrag, logges også.
• Sletting. Notater og bilder ligger til de slettes i appen eller i admin. Slettes profilen, slettes personlige kanaler, spillelister og serier, hendelser, notater og bilder, og filer ingen bruker lenger.

Deles aldri med leverandører

• Beboerens navn, brukernavn, boks-ID, sted eller avdeling.
• Pårørendes navn, telefonnummer og relasjon, hvem som har skrevet et notat eller sendt et bilde, og hvem som ringte.
• Notater og bilder merket «Bare personalet», og alt eieren ikke har samtykket til.
• Bilder fra «titt inn», samtaler eller video fra TV-kameraet.

17Eksempel: en personlig kanal for Ingrid

Ingrid (profil p_7Kq2mPx9Qa i eksempelet) har leverandøren Enkel-TV. Hun har allerede den personlige kanalen enkeltv.ingrids-kanal på plass 6, med spillelisten enkeltv.ingrid-kveld. Slik lager leverandøren ukens spilleliste og forbedrer den, bare med API-et.

{
  "format": "enkeltv-slideshow/1",
  "title": "Bergen på 1950-tallet – for Ingrid",
  "language": "nb",
  "visibility": "personal",
  "profile": "p_7Kq2mPx9Qa",
  "defaults": { "text": { "style": { "size": 6, "background": "#00000099", "padding": 1.2 } } },
  "slides": [
    { "id": "torget", "duration": 14,
      "layers": [
        { "type": "image", "src": "media/torget-1954.jpg",
          "motion": { "from": { "scale": 1 }, "to": { "scale": 1.12, "x": 42, "y": 55 } } },
        { "type": "text", "text": "Du vokste opp i Bergen, Ingrid.", "x": 5, "y": 78, "w": 90,
          "align": "center", "start": 1, "fadeIn": 1 }
      ],
      "audio": [ { "src": "media/tale/torget.mp3", "start": 1.5, "duration": 9.8 } ],
      "credit": "Mittet & Co. / Nasjonalbiblioteket, 1954" }
  ]
}

curl -X PUT https://<server>/api/publish/slideshows/enkeltv.ingrid-bergen-1950 \
  -H "Authorization: Bearer etv_…" -H "Content-Type: application/zip" \
  --data-binary @enkeltv.ingrid-bergen-1950.zip

curl -X PUT https://<server>/api/publish/playlists/enkeltv.ingrid-kveld-uke41 \
  -H "Authorization: Bearer etv_…" -H "Content-Type: application/json" \
  --data-binary @enkeltv.ingrid-kveld-uke41.json

curl -X PATCH https://<server>/api/publish/profiles/p_7Kq2mPx9Qa/lineup \
  -H "Authorization: Bearer etv_…" -H "Content-Type: application/json" \
  -d '{ "slots": { "6": "enkeltv.ingrids-kanal" } }'

Leverandøren trenger aldri å vite hvem Ingrid er. Den ser bare p_7Kq2mPx9Qa, det eieren har samtykket til, og hva som ble sett – og serveren trenger aldri å vite hvordan innholdet ble valgt.

18Stabilitet og versjonering

• Formatene har versjon i navnet, f.eks. enkeltv-playlist/1, og serveren godtar bare navnene i dette dokumentet. GET /api/publish viser alltid formatene serveren bruker.
• Felt serveren ikke kjenner, fjernes når noe lagres. Det er derfor trygt å sende med egne felt, men de blir ikke lagret.
• Endringer som kan ødelegge for eksisterende leverandører, gir et nytt versjonsnummer (/2). Da tar serveren imot både den gamle og den nye versjonen i en overgangsperiode, og leverandørene får beskjed i god tid.
• Bare /api/publish er leverandør-API-et. TV-en, mobilappen for pårørende og admin for personalet bruker egne, interne endepunkter med innlogging. De er ikke en del av leverandør-API-et, kan endres sammen med appene og godtar ikke API-nøkler.

Denne dokumentasjonen

Dokumentasjonen ligger på serveren, alltid i samme versjon som API-et: som nettside på https://<server>/docs/ og som PDF på https://<server>/docs/enkeltv-api.pdf.

19Senere

Dette er bevisst ikke bygget ennå. Modellen er laget slik at det kan komme til uten at formatene over må endres.