IceJockey Audio API

Dokumentation + testverktyg för bibliotek, topplistor och loggning av uppspelningar.

Base URL: https://audio.icejockey.app

Autentisering (X-API-Key)

Externa integratörer behöver API-nyckel för topplista och loggning. Dina egna sidor på audio.icejockey.app kan fortsätta utan nyckel (same-site via Origin/Referer).

Kräver API key:

• GET /api/stats_top.php

• POST /api/track_play.php

Publikt:

• GET /library.json

• GET /api/health.php

X-API-Key X-API-Key: DIN_NYCKEL

Snabbtest (Playground)

API key (valfri här)

Hämtar topplista från stats_top.php

Range Limit client_id (valfri)

Skickar en test-logg till track_play.php

track_id (valfri) client_id (valfri) event_key played_ms

Svar

{}

Exempel (curl)

Med API key

# top week (requires key)
curl -s "https://audio.icejockey.app/api/stats_top.php?range=week&limit=10&client_id=arena_1" \
  -H "X-API-Key: DIN_NYCKEL"

# log play (requires key)
curl -s -X POST https://audio.icejockey.app/api/track_play.php \
  -H "X-API-Key: DIN_NYCKEL" \
  -F "track_id=goal_horn_1" \
  -F "client_id=arena_1" \
  -F "event_key=web" \
  -F "played_ms=5000"

Utan API key (publikt)

# library (public)
curl -s https://audio.icejockey.app/library.json

# health (public)
curl -s https://audio.icejockey.app/api/health.php

Rate limiting (rekommendation)

Om du öppnar API:t för andra: rekommendera t.ex. 60–120 req/min per key och dedupla loggning (cooldown per track).

Tips: logga bara om låten spelat minst 5s och max 1 gång/min per track per klient.