Co je NSP API?

Je to otevřené REST API (vrací JSON), které provozuje Ministerstvo práce a sociálních věcí ČR. Slouží ke stahování dat o profesích, kompetencích, kvalifikačních úrovních, digitálních/měkkých dovednostech a dalších souvisejících informací.

NSPI API v1.2

NSPI API v1.1

NSPI API v1.0

Hlavní větve API

				
					workUnit (profese)
├── /{slug} – detail profese
├── /{slug}/education – požadované vzdělání
├── /{slug}/competence – požadované kompetence
├── /{slug}/healthCondition – zdravotní omezení
├── /{slug}/digiCompetence – digitální dovednosti
├── /{slug}/softSkill – měkké dovednosti
└── /{slug}/nskCard – kvalifikace z NSK

professionalDirection (obory)
└── /{id}/workUnit – všechny profese v oboru

cdk
├── softSkill
│   ├── /{id} – detail dovednosti
│   ├── /{id}/level – úrovně dovednosti
│   └── /{id}/workUnit – profese, které ji vyžadují
└── digi
    ├── /{id} – detail digitální kompetence
    ├── /{id}/level – úrovně dovednosti
    └── /{id}/workUnit – profese, které ji vyžadují

lists (číselníky)
├── softSkillType
├── digiCompetenceLevelType
├── educationType
└── employmentRelationType

1. workUnit (profese) – centrální prvek

Základní stavební kámen: představuje konkrétní profesi.

Údaj	Endpoint
Detaily profese	/workUnit/{slug}
Požadované kompetence	/workUnit/{slug}/competence
Požadované vzdělání	/workUnit/{slug}/education
Zdravotní požadavky	/workUnit/{slug}/healthCondition
Digitální dovednosti	/workUnit/{slug}/digiCompetence
Měkké dovednosti (soft skills)	/workUnit/{slug}/softSkill
Odpovídající kvalifikace NSK	/workUnit/{slug}/nskCard

				
					/workUnit – získáte seznam všech profesí.
/workUnit/{urlSlug} – podrobný popis jedné profese podle unikátního odkazu.
/workUnit/{urlSlug}/competence, /.../education, /.../healthCondition – vrací specifické informace ke kompetencím, vzdělání, zdravotním požadavkům dané profese

2. professionalDirection (Odborné směry)

Tyto endpointy vrací sektory/obory práce – třeba „zdravotnictví“, „stavebnictví“.

Slouží hlavně k filtrování nebo kategorizaci.

				
					/professionalDirection/{id}/workUnit – vrátí všechny profese v daném oboru.

3. cdk (Core Descriptors)

Pomáhá s tzv. kvalifikačními deskriptory.

				
					Digitální kompetence: /cdk/digi/{id}, /.../level.
Měkké kompetence („soft skills“): /cdk/soft-skill, /.../{id}, /.../{id}/level, /.../{id}/workUnit

Všechny úrovně a typy dovedností jsou k dispozici jako formálně strukturovaná číselníková data.

4. lists

Obsahuje statické seznamy, které API používá. Pomáhají při interpretaci či zobrazování dat ze soft-skill či digi-větví.

Nepotřebují se žádné ID ani slug – stačí jen GET.
- Typické číselníky:
- softSkillType
- digiCompetenceLevelType
- educationType
- employmentRelationType

Pomáhají při zobrazení úrovní, kategorií nebo typů (např. „Digitální kompetence – úroveň 3“ = středně pokročilý).

				
					Typy soft-skillů (softSkillType), úrovně digitálních dovedností (digiCompetenceLevelType), další seznamy.

5. cdk (dovednosti/kompetence)

cdk/digi – Digitální kompetence

				
					/cdk/digi/{id} – informace o konkrétní digitální dovednosti. 
/cdk/digi/{id}/level – jaké jsou úrovně.
/cdk/digi/{id}/workUnit – u jakých profesí se tato dovednost vyskytuje.

cdk/soft-skill – Měkké dovednosti

				
					/cdk/soft-skill/{id} – info o jedné dovednosti.
/cdk/soft-skill/{id}/level – úrovně (např. "nízká", "střední", "vysoká").
/cdk/soft-skill/{id}/workUnit – seznam profesí, které ji vyžadují.

Jak se s tím pracuje?

Autentizace:
Vše je veřejné, stačí poslat (Accept: application/json). Není potřeba žádný klíč.
Volání API:
Jednoduše HTTP GET (https://www.nsp.cz/api/v1.2/workUnit?Accept=application/json)
Odezva: JSON – list profesí, detailní záznamy apod.
K čemu se to hodí:
Získat data pro katalogy povolání, e‑learning, poradenství, vzdělávací systémy.
Např. při vývoji portálů „jaké kompetence potřebuji pro tuto práci“, „jaké vzdělání je potřebné“…
Migrace z předchozích verzí:
V1.2 nahradila určité rozhraní měkkých dovedností a digitalizace – kompatibilita je zajištěna – pozor některé endpointy mají nové názvy a jinou strukturu.

				
					                       
                        +-------------------+
                        |   lists (číselníky)|
                        +---------+---------+
                                  |
               +-----------------+-----------------+
               |                                   |
     +---------v---------+            +------------v-----------+
     |  professionalDirection        |         cdk             |
     +-------------------+           |   (kompetence, skills)  |
               |                     +-----------+-------------+
               |                                 |
       +-------v--------+             +----------v----------+
       |   workUnit     <-------------+   softSkill / digi  |
       |   (profese)    +-------------v---------------------+
       +-------+--------+
               |
    +----------+----------+-----------------------------+
    |          |          |             |               |
    v          v          v             v               v
education  competence  healthCond  digiCompetence   softSkill
 (vzděl.)   (znalosti) (zdraví)     (digitální)     (měkké)