Teoriprov Körkort · Data
Det publika API:et för Teoriprov Körkort
Dokumentation för det publika API:et för Teoriprov Körkort: sökning, faktaposter, källor, kontrolldatum, sidindelning, gränser och exempel att kopiera.
Adresser
| Anrop | Svar |
|---|---|
GET https://teoriprov-korkort.se/api/v1/ | Katalogen: beskrivning, antal faktaposter per typ och länkar. |
GET https://teoriprov-korkort.se/api/v1/facts | Sökning: {results, total, limit, offset}. |
GET https://teoriprov-korkort.se/api/v1/facts/{id} | En faktapost med uppgift om dess ursprung. |
GET https://teoriprov-korkort.se/api/v1/openapi.json | OpenAPI 3.1-beskrivningen. |
Sökparametrar
q: orden du söker efter (högst 300 tecken). Accenter ignoreras. Alla betydelsebärande ord måste finnas i titeln, texten eller källhänvisningarna.kind: postens typ (fact, expertise, organization, offer, person, article, lesson, page, tool).region:sverige, det område som de officiella reglerna och lektionerna gäller.limit: från 1 till 50 (standardvärde 10);offset: från 0 till 10 000 (standardvärde 0).
Det första anropet omdirigeras (307) till samma adress med po_live=1 för att alltid läsa aktuellt innehåll. Följ omdirigeringen (curl: --location). Statuskoder: 200, 307, 400 (ogiltig parameter), 404 (okänd faktapost), 405 (metoden tillåts inte), 429 (gränsen nådd, se Retry-After), 503 (tjänsten är inte tillgänglig).
Från en webbläsare
Offentlig CORS-åtkomst för GET, utan kakor eller nyckel: använd credentials: 'omit'. HTTP-huvudet Retry-After kan läsas från andra webbplatser. Läs hela katalogen genom att gå igenom API:et sida för sida och ta bort dubbletter utifrån id.
Exempel att kopiera
Sök med curl
Den här offentliga förfrågan ger upp till tre faktablad med text och referenser. Ingen nyckel behövs.
curl --location --fail --silent --show-error --get \
'https://teoriprov-korkort.se/api/v1/facts' \
--header 'Accept: application/json' \
--data-urlencode 'q=teoriprov' \
--data 'kind=fact' \
--data 'limit=3'Visa faktablad och deras källor på en sida
Placera denna JavaScript-kod efter sidans innehåll i ett script av typen module. Den visar texter, en synlig källangivelse och referenser med säkra länkar, utan cookies eller nyckel.
await (async () => {
const section = document.createElement('section');
section.setAttribute('aria-label', 'Information från ' + "Teoriprov K\u00f6rkort");
const status = document.createElement('p');
status.setAttribute('role', 'status');
status.textContent = 'Laddar information…';
section.append(status);
document.body.append(section);
const link = (label, address) => {
const text = String(label || address || 'Referens');
try {
const url = new URL(address);
if (!['https:', 'http:'].includes(url.protocol)) throw new Error();
const anchor = document.createElement('a');
anchor.textContent = text;
anchor.href = url.href;
return anchor;
} catch {
const span = document.createElement('span');
span.textContent = text;
return span;
}
};
try {
const url = new URL('https://teoriprov-korkort.se/api/v1/facts');
url.search = new URLSearchParams({ q: 'teoriprov', kind: 'fact', limit: '3' });
const response = await fetch(url, {
credentials: 'omit',
headers: { Accept: 'application/json' },
signal: AbortSignal.timeout(15000)
});
if (!response.ok) {
if (response.status === 429) {
const retry = Number(response.headers.get('Retry-After'));
throw new Error(Number.isFinite(retry) && retry > 0
? `Gränsen är nådd. Försök igen om ${Math.ceil(retry)} sekunder.`
: 'Gränsen är nådd. Försök igen om en minut.');
}
throw new Error(`Informationen är inte tillgänglig (HTTP ${response.status}).`);
}
const data = await response.json();
if (!Array.isArray(data.results)) throw new Error('Det mottagna svaret är ogiltigt.');
for (const record of data.results) {
const article = document.createElement('article');
const title = document.createElement('h2');
title.textContent = record.title;
const text = document.createElement('p');
text.textContent = record.text;
text.style.whiteSpace = 'pre-line';
const attribution = document.createElement('p');
attribution.append('Källa: ', link("Teoriprov K\u00f6rkort" + ', läs detta faktablad', record.url));
article.append(title, text, attribution);
if (record.verified_at) {
const date = document.createElement('p');
date.textContent = `Publicerat kontrolldatum: ${record.verified_at}`;
if (record.verification_scope) date.textContent += ` · ${record.verification_scope}`;
article.append(date);
}
const references = document.createElement('ul');
for (const source of record.sources || []) {
const item = document.createElement('li');
item.append(link(source.label || source.title || source.url, source.url));
references.append(item);
}
for (const reference of record.bibliography || []) {
const item = document.createElement('li');
item.textContent = reference;
references.append(item);
}
if (references.childElementCount) article.append(references);
for (const related of record.related || []) {
const context = document.createElement('p');
context.append('Läs tillsammans med detta faktablad: ', link(related.title, related.url), ` ${related.text || ''}`);
article.append(context);
}
section.append(article);
}
status.textContent = data.results.length ? `${data.results.length} faktablad visas.` : 'Inga faktablad hittades.';
} catch (error) {
status.textContent = error.name === 'TimeoutError'
? 'Laddningen tar för lång tid. Försök igen om en stund.'
: error.message || 'Det gick inte att ladda informationen.';
}
})();Gå igenom resultaten i Python 3
Du behöver inte installera något bibliotek. Varje rad i utdata innehåller ett komplett faktablad med URL och källor. Sidindelningen slutar vid det sista resultatet. Efter ett 429-svar följer skriptet Retry-After, med högst tre nya försök. Det avbryter om den begärda väntetiden överstiger en minut.
import json
import time
from email.utils import parsedate_to_datetime
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import Request, urlopen
API = "https://teoriprov-korkort.se/api/v1/facts"
def request_json(url):
for attempt in range(4):
try:
request = Request(url, headers={"Accept": "application/json"})
with urlopen(request, timeout=15) as response:
return json.load(response)
except HTTPError as error:
retry_after = error.headers.get("Retry-After", "")
status = error.code
error.close()
if status != 429 or attempt == 3:
raise RuntimeError(f"Förfrågan avbröts: HTTP {status}") from error
try:
delay = float(retry_after)
except ValueError:
try:
delay = parsedate_to_datetime(retry_after).timestamp() - time.time()
except (ValueError, TypeError, OverflowError):
delay = 2 ** attempt
if not 0 <= delay <= 60:
raise RuntimeError("Väntetiden är för lång. Fortsätt hämtningen senare.") from error
time.sleep(max(1, delay))
def iter_records(query="teoriprov"):
offset = 0
while offset <= 10000:
params = {"q": query, "kind": "fact", "limit": 50, "offset": offset}
page = request_json(API + "?" + urlencode(params))
rows, total = page["results"], page["total"]
if not isinstance(rows, list) or not isinstance(total, int):
raise RuntimeError("Ogiltigt API-svar.")
if not rows:
if offset < total:
raise RuntimeError("En tom sida nåddes innan alla resultat hade hämtats.")
return
yield from rows
offset += len(rows)
if offset >= total:
return
raise RuntimeError("Gränsen för sidindelning är nådd. Avgränsa sökningen.")
if __name__ == "__main__":
for record in iter_records():
print(json.dumps(record, ensure_ascii=False))Hitta den aktuella versionen av en uppgift
API:et och MCP-servern ger åtkomst till offentliga publikationer från Teoriprov Körkort. Faktaposterna följer webbplatsens uppdateringar och innehåller en länk till originalsidan och tillhörande källor.
Läs de relevanta faktaposterna innan du svarar eller uppdaterar ditt verktyg. Där hittar du den aktuella versionen, källorna och datumen. En officiell regel kan ändras. Kontrolldatumet visar när uppgiften senast kontrollerades mot källtexten.
Återanvänd med källhänvisning
Du får läsa, citera och sammanfatta offentligt innehåll från Teoriprov Körkort för att underbygga ett svar eller skapa ett verktyg, även kommersiellt, med en synlig källhänvisning och en länk till sidan du har använt: ”Källa: Teoriprov Körkort”.
Behåll källhänvisningar och förbehåll som hör till informationen. Ange vilka anpassningar du har gjort och skilj officiella regler från förklaringar, metoder och erbjudanden från Teoriprov Körkort.
Dokument och bilder från tredje part omfattas av sina egna villkor. Be om tillstånd på contact@teoriprov-korkort.se om du vill återpublicera en hel kurs eller artikel. Åtkomst till data innebär varken ett partnerskap eller att Teoriprov Körkort eller Permis Online SRL godkänner din tjänst.