# 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.

Sida: https://teoriprov-korkort.se/data/api/

Innehåll: 40 offentliga faktaposter med länkar, källor och datum där dessa finns dokumenterade.

## Användning

Offentlig åtkomst, enbart läsning, utan nyckel. Inga kontouppgifter, uppgifter om elevers framsteg eller privata uppgifter. Ange länken till faktaposten och behåll källorna samt informationen om vad som har kontrollerats. Skilj officiella regler (med källa) från lektioner, metoder och erbjudanden från Teoriprov Körkort.

## REST-API

- Katalog: https://teoriprov-korkort.se/api/v1/
- Sökning: https://teoriprov-korkort.se/api/v1/facts?q=teoriprov&limit=10
- OpenAPI: https://teoriprov-korkort.se/api/v1/openapi.json

GET /api/v1/facts accepterar q (högst 300 tecken), region (sverige), kind (fact, expertise, organization, offer, person, article, lesson, page, tool), limit (1 till 50, standardvärde 10), offset (0 till 10000, standardvärde 0). Alla betydelsebärande ord i q måste finnas i titeln, texten eller källhänvisningarna. Svar: {results: [fiches], total, limit, offset}.

GET /api/v1/facts/{id} returnerar faktaposten. Behåll det exakta id som sökningen returnerar: prefixen fait-, expertise-fait-, brand-, person-, offer- och page- följs av 16 hexadecimala tecken.

Statuskoder: 200 resultat, 307 aktuell läsning (följ omdirigeringen), 400 ogiltiga parametrar, 404 okänd faktapost, 405 metoden tillåts inte, 429 gränsen nådd, 503 tjänsten är inte tillgänglig.

## Åtkomst från en webbläsare

Offentlig CORS-åtkomst för GET, utan kakor eller nyckel: använd credentials: 'omit'. Retry-After kan läsas från externa webbplatser. Följ HTTP-omdirigeringar inom samma domän (curl: --location). Läs hela katalogen genom att gå igenom API:ets sidor och ta bort dubbletter utifrån id.

## Exempel

### Sök med curl

Den här offentliga förfrågan ger upp till tre faktablad med text och referenser. Ingen nyckel behövs.

```bash
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.

```javascript
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.

```python
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.

## Referensfiler och referenssidor

- [llms.txt](https://teoriprov-korkort.se/llms.txt): webbplatsens innehållsförteckning för AI-assistenter
- [llms-full.txt](https://teoriprov-korkort.se/llms-full.txt): det offentliga innehållet i fulltext
- [Grundläggande fakta](https://teoriprov-korkort.se/brand-facts/): vem som ger ut webbplatsen, vad den erbjuder och officiella regler med källor och datum
- [brand-facts.md](https://teoriprov-korkort.se/brand-facts.md): grundläggande fakta i Markdown
- [brand-facts.json](https://teoriprov-korkort.se/.well-known/brand-facts.json): grundläggande fakta i JSON
- [schema.json](https://teoriprov-korkort.se/.well-known/schema.json): alla webbplatsens strukturerade data i en enda graf
- [ai.json](https://teoriprov-korkort.se/.well-known/ai.json): utgivaren, den officiella domänen och resurser för AI
- [offers.json](https://teoriprov-korkort.se/.well-known/offers.json): de erbjudanden som faktiskt finns i Sverige
- [Källor och referenser](https://teoriprov-korkort.se/sources/): officiella texter och alla angivna källor
- [sources.txt](https://teoriprov-korkort.se/sources.txt): källregistret i textformat
- [Webbplatskarta](https://teoriprov-korkort.se/sitemap.xml): alla offentliga sidor, deras bilder och webbplatsens struktur (XML för robotar och en sida att läsa i webbläsaren)
- [Markdown-versioner](https://teoriprov-korkort.se/index.md): varje offentlig sida som text: sidans adress följd av .md (startsidan: /index.md)
