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 nettsideVis spillere, status og «Koble til»-knapp for serveren din på nettsiden eller i Tebex-butikken.
🤖 Discord-boterLag kommandoer som /spillere eller automatiske kanaler med spillertall og topplister.
📈 Statistikk og graferFølg utviklingen i norsk FiveM over tid, sammenlign servere eller lag egne dashbord.
📅 Kalendere og nyheterHent kommende eventer og nyheter fra servere til egne apper, strømmeoverlegg eller nyhetsbrev.
🎥 StrømmeoverleggVis live spillertall eller serverinfo i OBS mens du strømmer.
🛠️ Drift og overvåkingSjekk driftsstatus for FiveM Norge i dine egne verktøy, og få beskjed når noe er galt.
Kom i gang
- Logg inn med Discord – samme konto som på fivemnorge.xyz.
- Søk om en nøkkel. Fortell hva tjenesten skal gjøre, og skriv inn IP-adressene eller domenene som skal bruke API-et.
- Vent på godkjenning. FiveM Norge går gjennom søknaden, og du får varsel når den er behandlet.
- 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.
| Hendelse | Når |
|---|
server.online | Server kom på nett |
server.offline | Server gikk ned |
news.new | Ny nyhet |
event.start | Event starter |
status.incident | Driftsmelding fra FiveM Norge |
ping | Nå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.0Ferdig 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.
- IP-adresse (
203.0.113.10, 2001:db8::1) eller et nett (203.0.113.0/24): for servere og boter som kaller API-et direkte. - Domene (
minserver.no): godtar kall fra nettsider på domenet (i nettleseren, via Origin) og fra serveren domenet peker til. - Underdomener (
*.minserver.no): godtar alle underdomener i nettleseren.
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/trending
Populært nå
Servere som vokser mest akkurat nå. ?limit= (1–20).
Eksempel på svar
{ "data": [ { "id": "abc123", "name": "Nordic RP", "players": 128, "growth": 0.34 } ] }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
| Status | Kode | Betyr |
| 401 | missing_key / invalid_key | Nøkkelen mangler, er feil eller er trukket tilbake. |
| 403 | origin_not_allowed | Forespørselen kommer fra en IP eller et domene som ikke er registrert for nøkkelen. |
| 404 | not_found | Endepunktet, serveren eller brukeren finnes ikke. |
| 429 | rate_limited | For mange forespørsler. Vent til tiden i Retry-After. |
| 500 | server_error | Feil 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
- API-et er gratis for norske FiveM-servere, utviklere og skapere.
- Ikke del nøkkelen med andre, og ikke selg videre data fra API-et.
- Vis gjerne «Data fra FiveM Norge» med lenke til fivemnorge.xyz der dataene brukes.
- Ikke prøv å omgå grensene, og ikke bruk API-et til å kartlegge enkeltpersoner.
- FiveM Norge kan endre grenser og trekke tilbake nøkler som misbrukes. Vi varsler før endringer som kan ødelegge integrasjoner.
- Spørsmål? support@fivemnorge.xyz