Utviklerdokumentasjon

API-er og integrasjoner

Alt du trenger for å koble egne systemer mot tjenestene dine hos OVIT Cloud: REST-API for Stream Sky, direkte tilgang på webhotell og VPS, og adressene du peker DNS-en din mot.

Stream Sky API

Et REST-API over HTTPS. Alt inn og ut er JSON.

Base-URLhttps://panel.streamsky.no/api/v1

FormatJSON

AutentiseringBearer-token

Med API-et kan du lese status på strømmen din, se om den er live, styre hvilke plattformer den speiles til, bytte scene, rotere nøkler og slå OBS-boksen din av og på — det samme du gjør i portalen, men fra din egen kode.

Autentisering

Send nøkkelen i Authorization-headeren på hver forespørsel.

# Hent strømmene dine
curl -H "Authorization: Bearer DIN_NOKKEL" \
     https://panel.streamsky.no/api/v1/streams

Slik får du en nøkkel

Nøkler utstedes av oss — send en henvendelse via support og oppgi hva integrasjonen skal gjøre. Du får en nøkkel som er bundet til din konto: den ser bare dine egne strømmer og bokser, aldri andre kunders.

Rettigheter

Rettighet	Gir tilgang til
`read`	Lese status, helse, destinasjoner og oppsett
`write`	Endre destinasjoner, scene, «straks tilbake», rotere nøkler, styre boks

Publiseringsnøklene dine returneres kun til write-nøkler. En read-nøkkel kan derfor trygt brukes i et dashbord eller en overvåkingsjobb uten at SRT-passordene dine eksponeres.

Endepunkter

Alle stier er relative til base-URL-en over.

Strømmer

Metode	Sti	Beskrivelse
GET	`/streams`	Alle strømmene dine
GET	`/streams/:navn`	Én strøm, med tilkoblingsadresser
GET	`/streams/:navn/health`	Live-status, bitrate og tilkobling
POST	`/streams/:navn/rotate`	Rotér publiseringsnøkkelen

Destinasjoner (Twitch, YouTube, Kick …)

Metode	Sti	Beskrivelse
GET	`/streams/:navn/destinations`	List destinasjoner
POST	`/streams/:navn/destinations`	Legg til destinasjon
PATCH	`/streams/:navn/destinations/:id`	Slå av/på eller endre
DELETE	`/streams/:navn/destinations/:id`	Fjern destinasjon

Scene og «straks tilbake»

Metode	Sti	Beskrivelse
PATCH	`/streams/:navn/brb`	Slå «straks tilbake»-scenen av eller på
GET	`/streams/:navn/switcher`	Les scenevalg
PATCH	`/streams/:navn/switcher`	Bytt scene

Cloud OBS Box

Metode	Sti	Beskrivelse
GET	`/streamboxes`	Boksene dine og status
POST	`/streamboxes/:id/power`	Start, stopp eller omstart
GET	`/streamboxes/:id/overlay`	Hent overlay
POST	`/streamboxes/:id/overlay`	Last opp overlay
POST	`/streamboxes/:id/obs-import`	Importer OBS-scenesamling

Eksempel: er jeg live?

curl -s -H "Authorization: Bearer DIN_NOKKEL" \
     https://panel.streamsky.no/api/v1/streams/min-strom/health

{
  "live": true,
  "bitrateKbps": 5820,
  "since": "2026-08-18T09:14:02.311Z"
}

Eksempel: skru på «straks tilbake»

curl -X PATCH \
     -H "Authorization: Bearer DIN_NOKKEL" \
     -H "Content-Type: application/json" \
     -d '{"enabled": true}' \
     https://panel.streamsky.no/api/v1/streams/min-strom/brb

Feilkoder

Feil kommer alltid som JSON med et error-felt.

Kode	Betyr
`401`	Nøkkel mangler eller er ugyldig
`403`	Nøkkelen mangler nødvendig rettighet (`read`/`write`)
`404`	Fant ikke strømmen eller boksen
`409`	Navnet er opptatt av en annen konto
`423`	Tjenesten er i oppsigelsesperiode — kun stopp er tillatt

SRT uten API

Trenger du bare å sende signal, holder adressene fra portalen.

# Publisering (OBS, BELABOX, ffmpeg)
srt://srt.streamsky.no:8890?streamid=publish:NAVN:BRUKER:PASSORD

# SRTLA — bonding over flere modem
srtla://srt.streamsky.no:5050?streamid=publish:NAVN:BRUKER:PASSORD

# Avspilling
srt://srt.streamsky.no:8890?streamid=read:NAVN:BRUKER:PASSORD

Adressene inneholder passordet ditt. Del dem aldri i chat, på strøm eller i et offentlig kodelager. Er en adresse kommet på avveie, rotér nøkkelen i portalen eller via /rotate.

Webhotell for utviklere

Du får skall, database og et sertifikat som fornyer seg selv.

SSH og SFTPport 22

PHP8.3

DatabaseMariaDB 10.11

SSLLet's Encrypt, automatisk

# Filoverføring
sftp brukernavn@ovit.cloud

# Skall
ssh brukernavn@ovit.cloud

# Database (fra serveren)
mysql -u brukernavn -p databasenavn

Bruk SFTP, ikke FTP. Vanlig FTP på port 21 er stengt utenfra med hensikt — passord i klartekst hører ikke hjemme på nett. SFTP går over samme port som SSH (22) og krever ingen ekstra oppsett.

VPS

Full root, eget operativsystem, konsoll i nettleseren.

IP-adresse og rot-passord kommer i velkomst-e-posten. Du styrer maskinen fra Min side: start, stopp, omstart og konsoll — nyttig hvis du låser deg ute av SSH.

ssh root@DIN_IP

# Første kvarter på en ny maskin
passwd
apt update && apt upgrade -y

DNS og domener

Peker du domenet ditt hit, er dette verdiene du trenger.

A-record (webhotell)136.148.132.11

Navneserver 1ns1.ovit.cloud

Navneserver 2ns2.ovit.cloud

For .no-domener går registrering, overføring og navneserverbytte gjennom Norid. Alt skjer i domenekontrollen på Min side — vi er autorisert registrar, så du trenger ikke forholde deg til Norid direkte.

Endringer i navneservere slår ikke inn umiddelbart. Sett av opptil et døgn før alle oppslag ute i verden peker riktig vei.

Mangler du noe?

Bygger du en integrasjon vi ikke dekker ennå, vil vi gjerne høre det — det styrer hva vi bygger neste gang. Send oss en melding.