Publikt läskontrakt

Våra register går att läsa maskinellt. Kontraktet nedan beskriver vad som ingår, vad som aldrig kommer att ingå och hur saknade värden ska tolkas. Schemaversion 1.0.0.

Datamängder

• Programstatus per dimension och datum

  /api/programme-status.json

  JSONCSV

  Svensk programstatus uppdelad på formell nationell listning, universellt erbjudande, finansieringsnivå och beslutsläge, var för sig tidsbunden och bunden till källversion med exakt fyndplats.

  Stabil nyckel:

  diseaseKey

  Poster:

  2

  • temporalPosition FRAMTIDA betyder att tillståndet är beslutat men ännu inte gäller. Det får aldrig läsas som nuläge.
  • Ett universellt erbjudande kan finnas utan formell plats i det nationella allmänna programmet. Hepatit B är exemplet.
  • Saknas belägg redovisas verifiering-kravs. Fältet är inte en status utan en upplysning om att uppgiften inte är belagd.

• Governance- och beslutsregister

  /api/governance-decisions.json

  JSONCSV

  Projektets beslut om claim-modell och publiceringspolicy, med tidigare regel, ersatt tillstånd och implementationsläge.

  Stabil nyckel:

  id

  Poster:

  2

  • Ett tidigare tillstånd raderas aldrig. Det ligger kvar under history med datum och den post som ersatte det.
  • verificationStatus AUTOMATED_REGRESSION_ONLY betyder att automatiska tester håller regeln på plats. Det är inte en människas genomgång av sakinnehållet.

• Programområden

  /api/programme-areas.json

  JSONCSV

  Svenska barnvaccinationsprogrammets områden med programstatus och vilka steg i forskningskedjan som har registerpost hos oss.

  Stabil nyckel:

  key

  Poster:

  9

  • Ett vaccinbegrepp är inte en handelsprodukt, och en programrekommendation är inte en godkänd indikation.
  • Beslutat men ännu inte infört (vattkoppor) får aldrig läsas som en del av dagens schema.
  • hasRecord är ett redaktionellt täckningsmått för vår dokumentation, inte ett medicinskt omdöme.

• Datasetkatalog

  /api/dataset-catalog.json

  JSONCSV

  Alla publicerade datamängder med mått, enhet, nämnare, period och kvalitetsdimensioner.

  Stabil nyckel:

  id

  Poster:

  6

  • Måttet får aldrig läsas utan nämnare och period.
  • Maskinell hämtning och maskinell kontroll är inte mänsklig granskning – tre separata fält.

• Sjukdomsregister

  /api/diseases.json

  JSONCSV

  Sjukdomar i den publicerade svenska programversionen.

  Stabil nyckel:

  key

  Poster:

  11

  • Posten beskriver var sjukdomen behandlas hos oss, inte hur farlig den är.

• Produktregister

  /api/vaccine-products.json

  JSONCSV

  Handelsprodukter med produktdokument och belagt programläge.

  Stabil nyckel:

  key

  Poster:

  11

  • En handelsprodukt är inte samma sak som en programrekommendation.
  • Identitet härrör ur canonical_vaccine_product (projektion genererad 2026-09-03T11:29:57.714Z).

• Påståendeindex

  /api/claims.json

  JSONCSV

  Preciserade satser med frågetyp, kausalitetsläge och publiceringsläge. Ingen sanningspoäng.

  Stabil nyckel:

  id

  Poster:

  7

  • Ingen sammanvägd sanningspoäng finns. Träffsäkerhet, kunskapsläge, evidensstyrka och kausalitet är separata fält.
  • Ett associationsfynd är inte ett orsakssamband.

• Källregister

  /api/sources.json

  JSONCSV

  Dokument med utgivare, externa id:n och proveniensnivå.

  Stabil nyckel:

  id

  Poster:

  68

  • Att en källa finns i registret betyder inte att den stöder ett påstående.
  • Saknad källversion eller sidhänvisning redovisas som lucka och fylls aldrig i automatiskt.

• Beslutsregister

  /api/policy-decisions.json

  JSONCSV

  Svenska beslutsposter med datum, aktör och redovisade källuckor.

  Stabil nyckel:

  id

  Poster:

  13

  • Vad som var känt vid beslutstillfället hålls isär från senare utfall.

• Entitetsindex

  /api/entities.json

  JSONCSV

  Alla entiteter med publik yta, typ och externa id:n.

  Stabil nyckel:

  id

  Poster:

  161

  • Ett id utan publik sökväg betyder att entiteten saknar egen sida, inte att den saknas.

• Relationsindex

  /api/relations.json

  JSONCSV

  Typade relationer med period och källa per kant.

  Stabil nyckel:

  id

  Poster:

  165

  • En dokumenterad relation är inte bevisad påverkan. Härledningssteget säger vad som faktiskt är belagt.

CSV-speglingen

Varje datamängd finns också som CSV på samma adress med filändelsen .csv. CSV är en plattad spegling av JSON-payloaden: nästlade fält skrivs i punktnotation (review.lastUpdated) och listor separeras med |. En tom cell betyder att uppgiften saknas – aldrig noll, aldrig “ingen händelse”. JSON är originalet; vid skillnad gäller JSON.

Inbäddning

Enskilda granskade påståenden och källposter går att bädda in på andra sajter via /embed/pastaende/<id> och /embed/kalla/<id>. Ett oEmbed-svar finns statiskt på /api/oembed/<typ>/<id>.json, och /api/embeddable.json listar allt som går att bädda in. Varje kort bär källa, datum och osäkerhetsmarkering. Ett kort får inte publiceras utan dem, och innehållet får inte återges starkare än posten.

Fält som aldrig publiceras

Interna arbetsfält hålls utanför alla publika svar. Det gäller bland annat:

• reviewer
• reviewerLabel
• internal
• internalNotes
• privatePaths
• adminStatus
• notes

Villkor

Använd gärna materialet, men behåll källhänvisningen och skriv aldrig om ett saknat värde till ett faktiskt värde. Kontraktet kan ändras när underliggande register förbättras. Materiella ändringar loggas i ändringsflödet. Vi lovar ingen tillgänglighetsnivå och ingen fast uppdateringsfrekvens.