API

Allt i Fornmed finns i ett öppet REST-API. Det kräver ingen nyckel och beskrivs med OpenAPI.

Adressen är https://api.fornmed.se. Dokumentationen med alla resurser och parametrar finns på api.fornmed.se/docs, och beskrivningen på /openapi.json.

Format

Alla resurser finns som JSON, Markdown och text, och listor också som CSV. Formatet väljs med format=json, md, txt eller csv, eller med Accept-huvudet. Markdown och text inleds med en källhänvisning: verk, utgåva, språk och licens.

Dokument

Ett verk hämtas helt i ett svar:

https://api.fornmed.se/v1/verk/verk:lag:aldre_vastgotalagen/text?format=md

Stora verk kan också hämtas del för del, till exempel en balk eller en bok: /v1/verk/{id}/delar listar delarna. sprak= väljer språkversion i prioritetsordning (sprak=swe,dan,lat), och sprak=fsv,swe&parallellt=true ger original och översättning passage för passage.

Listor och sökning

• /v1/sok?q=…: sökning, som MCP-verktyget
• /v1/verk, /v1/pastaenden, /v1/bedomningar: listor med filter
• /v1/auktoriteter/biskopar?sate=Uppsala&format=csv: ärkebiskoparna i Uppsala
• /v1/leveranser: databasens uppdateringar

Listor delas upp i sidor med sida och per_sida. Hela databasen går inte att hämta i ett anrop; hämta de dokument och listor du behöver.

Villkor

API:et är öppet med en gräns på tio anrop i sekunden per adress. Licensen för texterna anges i varje svar och i källförteckningen. Maskinöversättningar är märkta som ogranskade.