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 restream 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. Restream
• 6. «Straks tilbake» og scenebytte
• 7. OBS-boksene dine
• 8. Publiseringsadressene
• 9. Bygg din egen sendeboks
• 10. 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 restream-kanal 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",
  "restreamOn": true,
  "restreamAllowed": true,
  "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. Restream

Restream vil si at vi tar imot sendingen din én gang og sender en kopi videre til hver kanal du har satt opp — Twitch, YouTube, Facebook, Kick, din egen RTMP-adresse, eller en ren SRT-adresse. Kopiene går ut fra datasenteret vårt, ikke fra maskinen din, så du laster opp én gang uansett hvor mange kanaler du bruker. Restream er en egen tjeneste som legges til på abonnementet — får du 403 med needsRestream: true, er det fordi den ikke er bestilt. (Automatisk scenebytte er noe annet: den krever OBS-boks, og svarer needsBox: true.)

Det er to brytere, og de gjør ikke det samme. PATCH …/restream er hovedbryteren for hele funksjonen: står den av, sendes ingenting ut, men kanalene og nøklene dine beholdes uendret. PATCH …/destinations/:id med enabled slår én enkelt kanal av og på. Feltet restreamOn i health og destinations (der heter det on) forteller hva hovedbryteren står på.

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

Å slå av går alltid — også når abonnementet ikke er aktivt. Å slå på krever aktivt abonnement (423 ellers) og at funksjonen er åpen for kontoen din (403 ellers, med begrunnelsen i error).

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 — hver aktiv kanal er en full kopi av bitraten din — så det er de påskrudde kanalene 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}'

«Straks tilbake» krever SRT-linje og Restream: linja måler signalet, og pauseskjermen sendes ut på restream-kanalene dine. Automatisk scenebytte krever en enhet med OBS — enten en OBS-boks fra oss, eller din egen maskin koblet til med Stream Sky-agenten. Mangler forutsetningen, svarer vi 403 med en forklaring i error.

6b. Fjernstyring og OBS-styring

Start og stopp sendingen, bytt scene og styr opptak — det samme fjernstyringen gjør fra mobilen. Inkludert i SRT-linja: du trenger verken OBS-boks eller Restream.

Alt her er engangshandlinger med nonce, ikke tilstand. Ber du om et scenebytte mens enheten er nede, kastes det etter to minutter — det skal ikke utføres på en helt annen sending timer senere. Enheten kvitterer, og feltene i kontroll oppdateres når den har gjort jobben.

6c. Dine egne nøkler

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 direkte 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>

RTMP er delt i to felt, fordi det er slik OBS og de fleste encodere spør om det: rtmpServer hører hjemme i «Server», og rtmpKey i «Streamnøkkel». Kreds ligger i nøkkelen, ikke i serveradressen:

Server:       rtmp://srt.streamsky.no:1935/
Streamnøkkel: <strøm>?user=<bruker>&pass=<hemmelighet>

SRT gir lavere forsinkelse og tåler ustabilt nett langt bedre. Bruk RTMP når utstyret ditt ikke støtter SRT — ikke som førstevalg.

9. Bygg din egen sendeboks

Vil du bygge din egen IRL-boks — en Raspberry Pi, en Radxa, eller noe helt annet — finnes det et eget enhets-API for det. Boksen din blir da en enhet vi kjenner: du ser den i portalen, og du kan starte, stoppe og oppdatere sendingen fra fjernstyringen på mobilen, akkurat som med våre egne bokser.

Boksen ringer oss — ikke omvendt

Enheten din poller oss og henter ønsket tilstand. Vi kobler aldri inn til den. Det er med vilje: en IRL-boks står på mobilnett bak CGNAT og har ingen adresse vi kunne nådd. Så lenge boksen din kommer ut på HTTPS, virker fjernstyringen — uten tunnel, uten åpne porter, uten fast IP.

Merk at vi sender tilstand, ikke kommandoer i kø. Boksen sammenligner det vi ønsker med det den faktisk gjør, og retter opp. Har den vært borte en time, gjør den bare det som trengs nå — den spiller ikke av gamle kommandoer.

Steg 1: par enheten

Kunden lager en engangskode i portalen, eller via POST /api/v1/streams/:navn/paringskode med en write-nøkkel. Koden ser ut som SSKY-A3F9-K2M7-Q4XZ og varer i 15 minutter. Boksen bytter den i sitt eget, langlevde token:

curl -X POST https://panel.streamsky.no/api/enhet/par \
  -H "Content-Type: application/json" \
  -d "{\"kode\":\"SSKY-A3F9-K2M7-Q4XZ\",\"modell\":\"Raspberry Pi 4 Model B\",\"versjon\":\"1.0.0\"}"

{
  "ok": true, "apiVersjon": 1,
  "token": "agt_…",
  "stream": "minstrom",
  "srtla": { "host": "srt.streamsky.no", "port": 5050 },
  "srt":   { "host": "srt.streamsky.no", "port": 8890 }
}

Lagre tokenet trygt — det er enhetens legitimasjon fra nå av. Koden virker én gang. Parer kunden på nytt, mister den forrige enheten tilgangen — det er slik en mistet eller solgt boks kobles fra.

Steg 2: poll tilstanden

Hvert 2.–5. sekund. Her ligger både målingene våre og det kunden har trykket på i fjernstyringen:

curl -H "Authorization: Bearer agt_…" https://panel.streamsky.no/api/agent/state

{
  "ok": true, "apiVersjon": 1, "paired": true, "stream": "minstrom",
  "live": true, "kbps": 4200, "rttMs": 38,
  "kontroll": { "sending": "paa", "hovedscene": null, "handling": null },
  "publisering": {
    "srtla": "srtla://srt.streamsky.no:5050",
    "srt": "srt://srt.streamsky.no:8890",
    "streamid": "publish:minstrom:<bruker>:<hemmelighet>"
  }
}

Steg 3: meld tilbake

Uten dette står boksen din som «ingen kontakt» i portalen. Send den når noe endrer seg, og ellers hvert 20.–30. sekund:

POST https://panel.streamsky.no/api/agent/rapport
Authorization: Bearer agt_…

{
  "sender": true,
  "kvittering": "<nonce fra kontroll.handling, hvis du nettopp utførte en>",
  "enhet": {
    "versjon": "1.0.0", "bitrateKbps": 4200, "tempC": 61.5, "batteriProsent": 82,
    "lenker": [
      { "navn": "modem0", "oppe": true, "kbps": 2100 },
      { "navn": "modem1", "oppe": true, "kbps": 2100 }
    ]
  }
}

lenker er bonding-linjene dine — de vises i fjernstyringen, så kunden ser på mobilen hvilke modem som faktisk bærer. Maks 8. Alle tall klemmes til fornuftige intervaller og all tekst klippes; sender du noe rart, får du fortsatt 200, men vi lagrer bare det som gir mening.

Steg 4: meld deg av

Når enheten skal tas ut av bruk. Da forsvinner den fra portalen i stedet for å bli stående som offline for alltid:

POST https://panel.streamsky.no/api/agent/koble-fra
Authorization: Bearer agt_…

Versjoner og kompatibilitet

Hvert svar bærer apiVersjon. Vi legger gjerne til nye felt — det regnes ikke som en brytende endring, så boksen din må tåle felt den ikke kjenner. Endrer vi noe brytende, bumper vi tallet og sier fra i god tid. Sjekk gjerne at apiVersjon er den du bygde mot, og logg en advarsel hvis ikke.

Grenser

• Pareringen: 10 forsøk i minuttet per avsender. Bommer du på koden, vent litt.
• Poll og rapport: 240 kall i minuttet per enhetstoken. Poller du hvert 2. sekund er du på 30 — rikelig slakk til gjenoppkobling.
• Feiler et kall, vent og prøv igjen med gradvis lengre pause. Ikke hamre.

To ferdige utgangspunkt

1. Stream Sky-agenten — den vi selv anbefaler, og den kundene våre bruker. Ferdig, ikke et skjelett: to motorer (OBS over obs-websocket, eller din egen koder-kommando), automatisk innfylling av SRT-lenka i OBS, telemetri, backoff og oppstart som tjeneste. Windows, Linux og macOS. Kun standardbiblioteket. Full veiledning: streamsky.no/egen-maskin.

python3 streamsky-agent.py par SSKY-XXXX-XXXX-XXXX
python3 streamsky-agent.py oppsett --motor ffmpeg --kommando "ffmpeg ... -f mpegts {url}"
python3 streamsky-agent.py kjor

2. Referanseagenten — et kortere skjelett som viser hele samtalen uten annet støy: parering, polling, start og stopp, kvittering og rapportering. Det eneste du fyller ut selv er sender_kommando(). Bruk denne hvis du vil lese deg til protokollen før du skriver din egen klient.

sudo python3 streamsky-irl-agent.py par SSKY-XXXX-XXXX-XXXX
sudo python3 streamsky-irl-agent.py kjor

Hva bygger du selv?

Vi leverer plattformsiden. Selve sendingen er din: du trenger noe som koder video og noe som snakker SRT eller SRTLA mot oss. srtla og belacoder er åpen kildekode (GPL-3.0) og gjør begge deler godt — belacoder justerer bitraten løpende etter hvordan hver linje har det, som er det som får IRL til å fungere på ustabilt mobilnett.

Om maskinvare: velg et kort med maskinvarekoder for H.264. Raspberry Pi 5 og Jetson Orin Nano har ingen — der går all koding på CPU. Pi 4 har 1080p30. Rockchip RK3588 (Radxa ROCK 5B/5B+, Orange Pi 5) er merkbart sterkere, og 5B/5B+ har i tillegg HDMI-inngang, så kameraet går rett i kortet uten opptaksdongle.

10. 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.