Teknikaliteter

screenshot1

Lite om tekniska detaljer.

REST API

Det finns ett REST baserat API för att komma åt data som returnerar på application/json format. Här kommer några exempel.

Sökningar, returnerar lista med index.

Koncerner:

https://skolan.creado.se/api/model/search/get?cat=koncern&pagelen=2000

Enskilda huvudmän och koncerner ("privat" ersätts med "kommun" i annat fall) :

https://skolan.creado.se/api/model/search/get?cat=privat&pagelen=2000

Notera att koncerner kan vara huvudmän också, dvs. ha skolenheter direkt under sig.

Skolor:

https://skolan.creado.se/api/model/search/get?cat=skola&pagelen=10000

Detaljerad information för resurser

Index hämtat från tidigare sökning, organisationsnummer från skolverket eller andra källor.

huvudman:
Använd organisations nummer prefix "org":

https://skolan.creado.se/api/model/rsc/get/org5568089246

Eller index från sökresultat:

https://skolan.creado.se/api/model/rsc/get/3386

Kolla om huvdman ingår i koncern (orgnr kan bytas mot index):

https://skolan.creado.se/api/model/edge/get/org5568089246
{"result":{"i_koncern":[{"id":1719,"subject_id":3386,"predicate_id":341,"name":"i_koncern","object_id":3383,"seq":1000000,"created":"2022-11-17T23:02:29Z","creator_id":1}]},"status":"ok"}

koncern:

Samma som ovan egentligen.

https://skolan.creado.se/api/model/rsc/get/3383
https://skolan.creado.se/api/model/rsc/get/org5566742929

skola:

index eller "se" + skolenhetsnummer:

https://skolan.creado.se/api/model/rsc/get/3385
https://skolan.creado.se/api/model/rsc/get/se10373112

Vilken huvudman har skolan:

https://skolan.creado.se/api/model/edge/get/se10373112
{"result":{"huvudman":[{"id":1718,"subject_id":3385,"predicate_id":343,"name":"huvudman","object_id":3384,"seq":1000000,"created":"2022-11-17T23:02:27Z","creator_id":1}]},"status":"ok"}

tomt resultat:

{"result":[],"status":"ok"}

Fältet category_id returneras i json.
340 - skola   (skolenhet)
339 - koncern (Koncernmoderbolag)
338 - aktiebolag
337 - privat  (kategori för alla typer av enskilda huvudmän)
336 - kommun
335 - jurper  (Juridisk Person)

skola är egen unik kategori.
Subkategorier:
jurper -> privat -> aktiebolag -> koncern
jurper -> kommun

Skolenheter har att fält "status" som kan vara "Aktiv", "Planerad" eller "Vilande". Statistik finns bara för aktiva skolenheter.

Hämta data från skolverket

Alla huvudmän:

https://skolan.creado.se/api/model/skolan_verket/get/huvudman

Alla skolenheter för en huvudman:

https://skolan.creado.se/api/model/skolan_verket/get/org5568089246

Statistik för en skola.

https://skolan.creado.se/api/model/skolan_verket/get/se54882637

Annars rekommenderas att använda Skolverkets egna API:er direkt då det innehåller mer detaljerad information.