Utviklere

Stream Sky API · versjon 1 · oppdatert 18. august 2026

Alt du kan gjøre fra «Min side» kan du også gjøre med HTTP. Du henter status på strømmen din, bytter strømnøkler, styrer videresending og «straks tilbake», setter grensene for automatisk scenebytte, og starter eller stopper OBS-boksen din — fra dine egne skript, fra en bot, eller fra et kontrollpanel du bygger selv.

• 1. Kom i gang
• 2. Tilgangsnivå
• 3. Feilkoder
• 4. Strømmene dine
• 5. Videresending
• 6. «Straks tilbake» og scenebytte
• 7. OBS-boksene dine
• 8. Publiseringsadressene
• 9. Grenser og god skikk

1. Kom i gang

Nøkler lager du selv under Min side → Utviklere. Du gir nøkkelen en etikett du kjenner igjen, velger tilgangsnivå, og får se selve verdien én eneste gang. Vi lagrer aldri verdien i klartekst, så mister du den, lager du bare en ny og tilbakekaller den gamle.

Nøkkelen er knyttet til kontoen din. Du ser og styrer bare dine egne strømmer og bokser — du trenger aldri oppgi hvem du er i forespørselen, for det vet vi allerede.

Første kall, for å se hva du har:

curl -s https://panel.streamsky.no/api/v1/streams \
  -H "Authorization: Bearer $STREAMSKY_KEY"

Svaret ser slik ut (med et lesenivå-tilgangsnivå, altså uten publiseringsdetaljer):

{
  "streams": [
    {
      "name": "ss-1234",
      "label": "IRL-linja mi",
      "owner": "deg@example.no",
      "plan": "active",
      "status": "active",
      "expiresAt": null,
      "live": true,
      "urls": { "srtHost": "srt.streamsky.no", "srtPort": "8890", "srtlaPort": "5050" }
    }
  ]
}

💡 Legg nøkkelen i en miljøvariabel i stedet for rett i skriptet (export STREAMSKY_KEY=…). Da havner den ikke i kommandohistorikken din, og ikke i et skript du senere deler.

2. Tilgangsnivå

En nøkkel har ett eller begge av to tilgangsnivåer. Velg alltid det laveste som holder: har boten din bare behov for å vise bitrate i en chat, skal den ikke kunne bytte nøklene dine.

Mangler nøkkelen nivået et kall krever, svarer vi 403 — vi utfører aldri halve operasjonen.

3. Feilkoder

Alle feil kommer som JSON med et error-felt du kan vise videre til deg selv eller brukerne dine. Statuskoden er den som forteller deg hva du skal gjøre.

4. Strømmene dine

Plassholdere i stiene skrives med kolon: :navn er navnet på strømmen slik det står i name-feltet, og :id er referansen på en videresending eller en boks.

Helse

curl -s https://panel.streamsky.no/api/v1/streams/ss-1234/health \
  -H "Authorization: Bearer $STREAMSKY_KEY"

{
  "ok": true,
  "live": true,
  "uptimeSince": "2026-08-18T09:41:12Z",
  "readers": 2,
  "bytesReceived": 184320512,
  "health": { "rttMs": 34, "mbpsIn": 5.8, "lossPct": 0.02 },
  "brb": false,
  "status": "active",
  "destinations": []
}

Vi returnerer bytesReceived rått i stedet for en ferdig utregnet bitrate: poller du med jevne mellomrom, regner du differansen selv og slipper å holde en åpen forbindelse mot oss.

Bytt strømnøkler

curl -s -X POST https://panel.streamsky.no/api/v1/streams/ss-1234/rotate \
  -H "Authorization: Bearer $STREAMSKY_KEY"

Dette bryter en pågående sending. De gamle lenkene slutter å virke med én gang, og du må lime inn den nye i OBS eller BELABOX før du kan gå live igjen. Har du en OBS-boks koblet til strømmen, oppdaterer vi den automatisk — feltet boxUpdated i svaret sier hvilken. Sender du akkurat nå, får du 423 hvis abonnementet ikke er aktivt; ellers får du de nye lenkene i svaret.

5. Videresending

En videresending er en kopi av strømmen din ut til Twitch, YouTube, Facebook, Kick eller din egen RTMP-adresse. Videresending krever at du også har en OBS-boks — får du 403 med needsBox: true, er det derfor.

curl -s -X POST https://panel.streamsky.no/api/v1/streams/ss-1234/destinations \
  -H "Authorization: Bearer $STREAMSKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"twitch","label":"Twitch","key":"live_xxxxxxxx","enabled":true}'

Bruk platform: "custom" hvis du sender til din egen adresse; da oppgir du url selv. Vi tar bare imot rtmp:// og rtmps://. Når du leser målene tilbake er adressen maskert — du ser nok til å kjenne igjen målet ditt, ikke nok til at noen kan bruke det. Sender du key som tom streng i en PATCH, betyr det «ikke endre nøkkelen».

Taket gjelder båndbredde, så det er de påskrudde målene som telles. Går du over, får du 409 med teksten som sier hvor mange du kan ha.

6. «Straks tilbake» og scenebytte

curl -s -X PATCH https://panel.streamsky.no/api/v1/streams/ss-1234/brb \
  -H "Authorization: Bearer $STREAMSKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"on":true}'

Begge funksjonene krever både SRT-linje og OBS-boks: linja måler signalet, boksen bytter scene. Uten begge svarer vi 403 med en forklaring i error.

7. OBS-boksene dine

curl -s -X POST https://panel.streamsky.no/api/v1/streamboxes/$BOKS/power \
  -H "Authorization: Bearer $STREAMSKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"start"}'

Boksen må være startet for å ta imot overlays eller et OBS-oppsett — ellers svarer vi 409. Overlay-lenken må være https:// og peke ut på internett; vi tar ikke imot adresser som peker innover i nettverket.

Til obs-import bruker du fila fra OBS → Scenesamling → Eksporter (ikke Profil → Eksporter — det er den forvekslingen folk gjør). Vi rører aldri profilen din, så SRT-lenka i boksen står som den står. Maks 1 MB.

8. Publiseringsadressene

Selve videoen sendes ikke gjennom API-et. Den går på UDP til:

De ferdige lenkene henter du med en write-nøkkel — de kommer i urls på strømmen din, som srtla, srtPublish og srtPlay. Formen er slik, der streamid bærer navnet på strømmen og publiseringsdetaljen din:

srt://srt.streamsky.no:8890?streamid=publish:<strøm>:<bruker>:<hemmelighet>

9. Grenser og god skikk

• Rundt 120 kall i minuttet per nøkkel. Over det svarer vi 429. Trenger du mer, si fra — da finner vi ut av det sammen.
• Poll fornuftig. Hvert 5. sekund er rikelig for helse; portalen vår gjør det samme, og slutter å spørre når fanen ligger i bakgrunnen.
• Én nøkkel per ting. Har boten din og overvåkingsskriptet ditt hver sin nøkkel, kan du tilbakekalle den ene uten å ta ned den andre.
• Vi logger bruken av hver nøkkel — antall kall, avviste forsøk og når den sist ble brukt. Det ser du selv under Min side → Utviklere. Ser vi et mønster som tyder på misbruk, varsles vi, og vi kan slå av nøkkelen. Blir en nøkkel slått av av oss, står det der.
• Tilbakekall er umiddelbart. Sletter du en nøkkel, svarer neste kall 401.

Trenger du hjelp?

Står du fast, eller mangler du et endepunkt for noe du prøver å få til — åpne en supportsak, så svarer vi. Du kan også bruke kontaktskjemaet.

Del aldri nøkkelen din eller en publiseringslenke i en supportsak. Vi trenger dem ikke — de første tegnene i nøkkelen holder for at vi finner den igjen.