VisiCore Signage API – dokumentation

Kom igång

1. Skapa en API-nyckel i appen under Administration → Signage API.
2. Hämta en skärms token under skärmens Inställningar → Åtkomst (eller via list_screens).

Bas-URL:

https://visicore.se/signage_api.php

Autentisering

Skicka API-nyckeln som parametern key eller headern X-Api-Key. Nyckeln ger åtkomst till ett företags skärmar.

För åtgärder mot en enskild skärm krävs även skärmens token. Skärmen måste tillhöra samma företag som nyckeln.

Åtgärder (`action`)

action	Token krävs	Beskrivning
`list_screens`	Nej	Lista företagets skärmar med token, zon, plats och status.
`set_volume`	Ja	Sätt volym. `value` = 0–100.
`mute`	Ja	Stäng av ljudet.
`unmute`	Ja	Slå på ljudet.
`blackout`	Ja	Svart skärm.
`fallback`	Ja	Visa fallback-skärmen.
`normal`	Ja	Återgå till normal visning.
`reload`	Ja	Ladda om spelaren.
`clear_cache`	Ja	Rensa cache och ladda om.
`status`	Ja	Läs spelarens status (state, senast sedd, cache, version).
`device_info`	Ja	Läs enhetsinformation (OS, webbläsare, IP, hårdvara, lagring, live-status).

Exempel

Lista skärmar

curl "https://visicore.se/signage_api.php?key=DIN_NYCKEL&action=list_screens"

{
  "success": true,
  "screens": [
    { "id": 12, "name": "Entré", "zone": "Plan 1", "player_token": "abc123…", "state": "playing", "last_seen_at": "2026-07-17 10:22:01" }
  ]
}

Sätt volym till 30%

curl -X POST "https://visicore.se/signage_api.php" \
     -d "key=DIN_NYCKEL" \
     -d "token=SKÄRM_TOKEN" \
     -d "action=set_volume" \
     -d "value=30"

Svart skärm / återgå

curl -X POST "https://visicore.se/signage_api.php" -d "key=DIN_NYCKEL&token=SKÄRM_TOKEN&action=blackout"
curl -X POST "https://visicore.se/signage_api.php" -d "key=DIN_NYCKEL&token=SKÄRM_TOKEN&action=normal"

Läs enhetsinformation

curl "https://visicore.se/signage_api.php?key=DIN_NYCKEL&token=SKÄRM_TOKEN&action=device_info"

{
  "success": true,
  "device": {
    "state": "playing",
    "public_ip": "83.x.x.x",
    "device_info": { "os": "Android", "browser": "Chrome/Chromium", "cpuCores": 4, "localIps": ["192.168.1.42"] },
    "live_state": { "mode": "playlist", "url": "/uploads/…mp4", "elapsed": 12.3 }
  }
}

Svar & fel

Alla svar är JSON med fältet success (true/false). Vid fel finns message och en HTTP-statuskod:

Kod	Betydelse
`401`	API-nyckel saknas
`403`	Ogiltig nyckel eller fel företag för skärmen
`404`	Skärmen hittades inte
`400`	Saknad/ogiltig parameter

Kommandon (blackout, reload m.m.) slår igenom på skärmen inom några sekunder. Volym/ljud gäller från nästa synk.

VisiCore · en tjänst från Nordic Crew Support AB