Offentlig API

Bygg med data fra norsk FiveM

FiveM Norge API gir deg servere, spillertall, statistikk, eventer, nyheter og mer – de samme dataene som driver fivemnorge.xyz og launcheren. Gratis å bruke, med nøkkel for sikkerhet.

Hva kan API-et brukes til?

📊 Serverstatus på egen nettside

Vis spillere, status og «Koble til»-knapp for serveren din på nettsiden eller i Tebex-butikken.

🤖 Discord-boter

Lag kommandoer som /spillere eller automatiske kanaler med spillertall og topplister.

📈 Statistikk og grafer

Følg utviklingen i norsk FiveM over tid, sammenlign servere eller lag egne dashbord.

📅 Kalendere og nyheter

Hent kommende eventer og nyheter fra servere til egne apper, strømmeoverlegg eller nyhetsbrev.

🎥 Strømmeoverlegg

Vis live spillertall eller serverinfo i OBS mens du strømmer.

🛠️ Drift og overvåking

Sjekk driftsstatus for FiveM Norge i dine egne verktøy, og få beskjed når noe er galt.

Kom i gang

  1. Logg inn med Discord – samme konto som på fivemnorge.xyz.
  2. Søk om en nøkkel. Fortell hva tjenesten skal gjøre, og skriv inn IP-adressene eller domenene som skal bruke API-et.
  3. Vent på godkjenning. FiveM Norge går gjennom søknaden, og du får varsel når den er behandlet.
  4. Hent nøkkelen under «Mine nøkler». Den vises bare én gang, så ta vare på den.

Autentisering

Send nøkkelen i hodet Authorization på hver forespørsel:

curl https://api.fivemnorge.xyz/v1/servers \
  -H "Authorization: Bearer fnk_dinnøkkel"
const res = await fetch('https://api.fivemnorge.xyz/v1/stats', {
  headers: { Authorization: 'Bearer ' + process.env.FIVEM_NORGE_API_KEY },
});
const { data } = await res.json();
console.log(`${data.players} spillere på ${data.servers} norske servere`);

Kodeeksempler

Kopier og tilpass. Legg nøkkelen i en miljøvariabel, ikke rett i koden.

JavaScript (Node.js 18+)
const API = 'https://api.fivemnorge.xyz/v1';
const headers = { Authorization: `Bearer ${process.env.FIVEM_NORGE_API_KEY}` };

const res = await fetch(`${API}/servers/abc123`, { headers });
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(`${data.name}: ${data.players}/${data.max} spillere`);
Python
import os, requests

API = "https://api.fivemnorge.xyz/v1"
headers = {"Authorization": f"Bearer {os.environ['FIVEM_NORGE_API_KEY']}"}

r = requests.get(f"{API}/stats", headers=headers, timeout=10)
r.raise_for_status()
data = r.json()["data"]
print(f"{data['players']} spillere på {data['servers']} norske servere")
Lua (FiveM, server-side)
PerformHttpRequest('https://api.fivemnorge.xyz/v1/servers/abc123', function(status, body)
  if status ~= 200 then return print('Feil: ' .. status) end
  local d = json.decode(body).data
  print(('%s: %d/%d spillere'):format(d.name, d.players, d.max))
end, 'GET', '', { ['Authorization'] = 'Bearer ' .. GetConvar('fivemnorge_api_key', '') })
Discord.js (v14) – /spillere
client.on('interactionCreate', async (i) => {
  if (!i.isChatInputCommand() || i.commandName !== 'spillere') return;
  const r = await fetch('https://api.fivemnorge.xyz/v1/servers/abc123', {
    headers: { Authorization: `Bearer ${process.env.FIVEM_NORGE_API_KEY}` },
  });
  const { data } = await r.json();
  await i.reply(data.online
    ? `🟢 **${data.name}**: ${data.players}/${data.max} spillere`
    : `🔴 **${data.name}** er ikke på nett akkurat nå`);
});
Sjekk signaturen på en webhook (Node.js)
import crypto from 'node:crypto';

app.post('/fivemnorge', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = 'sha256=' + crypto.createHmac('sha256', process.env.WEBHOOK_SECRET).update(req.body).digest('hex');
  if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(req.get('x-fnl-signature') || ''))) return res.sendStatus(401);
  const { event, data } = JSON.parse(req.body);
  console.log(event, data);
  res.sendStatus(200);
});

Prøv API-et

Logg inn og få en godkjent nøkkel for å teste endepunktene rett her på siden.

Webhooks

I stedet for å spørre hvert minutt kan FiveM Norge sende en POST til adressen din når noe skjer. Legg til webhooks under «Mine nøkler» (maks 3 per nøkkel). Hendelsene sjekkes hvert 5. minutt.

HendelseNår
server.onlineServer kom på nett
server.offlineServer gikk ned
news.newNy nyhet
event.startEvent starter
status.incidentDriftsmelding fra FiveM Norge
pingNår du trykker «Test»
POST https://din-tjeneste.no/fivemnorge
X-FNL-Event: server.offline
X-FNL-Signature: sha256=…

{ "event": "server.offline", "at": 1795080000000, "data": { "id": "abc123", "name": "Nordic RP" } }

Sjekk alltid signaturen: den er en HMAC-SHA256 av hele innholdet med hemmeligheten du får når du lager webhooken. Svar med 2xx innen 5 sekunder. En webhook som feiler 20 ganger på rad, slås av, og du får varsel.

FiveM-ressurs

fivemnorge 1.0.0

Ferdig ressurs for FiveM-serveren din: /norge viser spillertall i Norge, /nyheter viser nyhetene dere legger ut i staff-panelet, og /toppliste viser månedens mest aktive. Spillerne ser siste nyhet når de kobler til. Andre ressurser kan bruke exports.fivemnorge:GetStats().

set fivemnorge_api_key "fnk_..."
set fivemnorge_server_id "abc123"
ensure fivemnorge

Registrer IP-adressen til FiveM-serveren på nøkkelen.

Last ned zip

Uten kode

Vil du bare vise serveren på nettsiden din? Bruk widget-byggeren – den trenger ingen nøkkel.

Sikkerhet: IP-adresser og domener

Hver nøkkel virker bare fra adressene du har registrert. Det gjør nøkkelen verdiløs for andre hvis den skulle lekke.

Bruker du nøkkelen i nettleseren, kan andre se den. Det er greit fordi den bare virker fra domenet ditt, men vi anbefaler å kalle API-et fra en server når du kan.

Grenser

Standard er 60 forespørsler i minuttet og 10 000 i døgnet per nøkkel. Trenger du mer, skriv det i søknaden. Hvert svar har hodene X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Daily-Remaining. Dataene oppdateres omtrent hvert minutt, så det er ingen grunn til å spørre oftere enn det.

Endepunkter

Alle svar er JSON med data og meta. Tider er millisekunder siden 1970 (UTC). Adressen er https://api.fivemnorge.xyz.

GET/v1/servers

Norske servere på nett

Alle norske FiveM-servere som er på nett nå, med spillere, tagger, vurdering og tilkoblingsadresse. Filtrer med ?search= og begrens med ?limit= (maks 500).

Eksempel på svar
{
  "data": [
    { "id": "abc123", "name": "Nordic RP", "players": 128, "max": 200, "tags": ["rp", "norsk"],
      "verified": true, "rating": { "avg": 4.6, "count": 31 }, "connect": "cfx.re/join/abc123", "icon": "https://…" }
  ],
  "meta": { "count": 1, "total_players": 128, "at": 1795080000000 }
}
GET/v1/servers/{id}

Én server

Alt offentlig om én server: status, spillere, beskrivelse, Discord, nettside, vurdering, nyheter og spillere de siste 14 dagene.

Eksempel på svar
{
  "data": { "id": "abc123", "name": "Nordic RP", "online": true, "players": 128, "max": 200,
    "description": "…", "discord": "https://discord.gg/…", "website": "https://…",
    "rating": { "avg": 4.6, "count": 31 }, "news": [ … ], "history": [[1795000000000, 97], …] }
}
GET/v1/stats

Tall for Norge

Spillere og servere på nett akkurat nå, og registrerte brukere på FiveM Norge.

Eksempel på svar
{ "data": { "players": 1543, "servers": 85, "users": 4210, "at": 1795080000000 } }
GET/v1/players

Spillere over tid

Antall spillere på norske servere, én måling i timen. Velg periode med ?hours= (1–168, standard 24).

Eksempel på svar
{ "data": [[1795000000000, 1210], [1795003600000, 1302], …] }
GET/v1/toplist

Toppliste

Månedens mest aktive spillere (de som har gjort profilen offentlig). Bare én server: ?server=abc123.

Eksempel på svar
{ "data": { "month": "2026-11", "players": [ { "name": "kari", "minutes": 5230 } ] } }
GET/v1/events

Arrangementer

Kommende eventer på norske servere (kalenderen på fivemnorge.xyz).

Eksempel på svar
{ "data": [ { "id": 12, "title": "Bilshow", "server": { "id": "abc123", "name": "Nordic RP" }, "starts_at": 1795100000000 } ] }
GET/v1/news

Nyheter fra servere

Siste nyheter som servere og partnere har lagt ut. Bare én server: ?server=abc123.

Eksempel på svar
{ "data": [ { "id": "…", "server_id": "abc123", "title": "Ny oppdatering", "body": "…", "at": 1795080000000 } ] }
GET/v1/jobs

Ledige stillinger

Stillinger servere søker etter (stab, utviklere og lignende). Bare én server: ?server=abc123.

Eksempel på svar
{ "data": [ { "id": "…", "title": "Moderator", "server": { "id": "abc123", "name": "Nordic RP" } } ] }
GET/v1/partners

Partnere

Partnerne til FiveM Norge.

Eksempel på svar
{ "data": [ { "name": "Nordic Hosting", "description": "…", "url": "https://…", "logo": "https://…" } ] }
GET/v1/status

Driftsstatus

Status for tjenestene til FiveM Norge og aktive meldinger fra status.fivemnorge.xyz.

Eksempel på svar
{ "data": { "overall": "ok", "components": [ { "id": "site", "name": "Nettsiden", "status": "ok", "uptime": 99.98 } ], "messages": [] } }
GET/v1/users/{brukernavn}

Offentlig profil

Profilen til en bruker som har gjort den offentlig i launcheren: merker, timer spilt og favorittservere.

Eksempel på svar
{ "data": { "name": "kari", "since": 1780000000000, "total": { "hours": 312, "servers": 14 }, "badges": [ … ] } }

Feilkoder

StatusKodeBetyr
401missing_key / invalid_keyNøkkelen mangler, er feil eller er trukket tilbake.
403origin_not_allowedForespørselen kommer fra en IP eller et domene som ikke er registrert for nøkkelen.
404not_foundEndepunktet, serveren eller brukeren finnes ikke.
429rate_limitedFor mange forespørsler. Vent til tiden i Retry-After.
500server_errorFeil hos oss. Sjekk driftsstatus.
{ "error": { "code": "origin_not_allowed", "message": "Forespørselen kommer fra 198.51.100.7, som ikke er registrert for denne nøkkelen." } }

Vilkår for bruk