esc
↑↓ velg↵ åpneesc lukk

Bidra til registeret

Felles datakatalog dekker mye, men ikke alt, og etatenes egne beskrivelser er ofte tynne. Det som gjør registeret nyttig er håndplukkede oppføringer: hva API-et faktisk gir deg, hvordan du får tilgang, og ett kall som virker. Kjenner du et API som mangler, eller ser en feil, er det tre måter å bidra på.

1. Foreslå et API i et skjema

Det raskeste. Fyll ut skjemaet for nytt API på GitHub med navn, leverandør, dokumentasjonslenke og hva det krever av tilgang. Vi legger det inn og krediterer deg i commit-meldingen.

2. Meld en feil

Hver API-side har lenken «Meld en feil i oppføringen». Den åpner et utfylt skjema med API-ets id, så du bare trenger å skrive hva som er galt: død lenke, feil tilgangsnivå, utdatert beskrivelse.

3. Send en pull request

Håndplukkede oppføringer er én YAML-fil per leverandør i registry/curated/. Legg til et API slik, kjør uv run norapi build og uv run norapi check --curated-only, og åpne en pull request.

updated: 2026-10-15
provider:
  name: Eksempeletaten
  orgnr: "123456789"
  sector: stat
apis:
  - id: eksempeletaten-saker
    title: Saksoppslag API
    description: >-
      Oppslag i saker per saksnummer, med status og dokumentliste.
    category: offentlig-forvaltning
    access: open
    auth: none
    formats: [JSON]
    endpoints:
      - https://api.eksempeletaten.no/saker/v1
    docs_url: https://eksempeletaten.no/api
    license: NLOD 2.0
    keywords: [saker, saksnummer, innsyn]
    quick_start: |
      curl "https://api.eksempeletaten.no/saker/v1/2026-001"

Feltene access (open, restricted, non-public, unknown) og auth (none, api-key, maskinporten, id-porten, oauth2, unknown) er faste verdier. quick_start skal være et kall som svarer uten avtale, eller tydelig si hva som trengs. Finnes API-et allerede i Felles datakatalog, matcher vi på endepunkt eller merge_with, og dine felter vinner over katalogens. Har API-et forbehold, som udokumentert grensesnitt, begrensende vilkår eller innlogging for deler av det, skriv dem som korte punkter i caveats; de vises som «Forbehold» på API-siden, i llms.txt og i MCP-svarene.

Hva som hører hjemme her

Se også