Nápověda

API

Systém NSP poskytuje JSON REST API rozhraní pro stažení dat, kompletní API dokumentaci lze nalézt zde:
v1.2 /api/doc/v1.2
v1.1 /api/doc/v1.1
v1.0 /api/doc/v1
v1 je také stále dostupné na adrese /api/doc

Pro komunikaci s API je nutné použít HTTP hlavičku:

'Accept':'application/json'

Novinky 01.2022:

Nahrazení číselníků měkkých kompetencí (deprekace v1.1 a v1 endpointů), nová verze api v1.2

/{v1,v1.1}/workUnit/{urlSlug}/competence

nahrazuje:
```
/v1.2/workUnit/{urlSlug}/competence
```

```
/v1.1/cdk/soft-skill
```
- nahrazuje stejná stuktura enpodintů jako u digitální kompetencí (pro migraci ze staré struktury měkkých kompetencí každá kompetence, která existovala v původním čísleníku nese property legacySoftSkillCode):
```
/api/v1.2/cdk/soft-skill
/api/v1.2/cdk/soft-skill/{id}
/api/v1.2/cdk/soft-skill/{id}/level
/api/v1.2/cdk/soft-skill/{id}/workUnit
```
Endpointy
```
/v1.1/lists/softSkillLevel
/v1.1/lists/softSkillLevel/{id}
```
mají ve v1.2 jiné konstanty a názvy, ale migrace dle id je možná 1:1.

Nové čísleníky v api v1.2

/v1.1/lists/softSkillLevel
/v1.1/lists/softSkillLevel/{id}
/v1.1/lists/softSkillType
/v1.1/lists/softSkillType/{id}

Novinky 01.2021:

(Beta) API CDK /cdk/digi
- ```
/cdk/digi/{id}
```
  Nyní vrací pole úrovní včetně descriptions
- ```
/cdk/digi/{id}/level
```
  Nový api call vrací pouze úrovně pro kompetenci
- ```
/lists/digiCompetenceLevelType
```
  Úrovně jsou nyní 4 místo původních 8

Novinky 11.2020:

API v1.1
- /workUnit/{urlSlug}/competence je nyní rozdělena na kompetence podle typu {competences,softSkills,genericSkills}
- Číselníky /lists jsou nyní deklarovány v dokumentaci api včetně modelů
- Číselníky /lists/{competenceType, genericHardSkillLevel, specificHardSkillLevel} byly odstraněny
API CDK bylo stabilizováno a je dostupné od API v1.1 původní cesty /api/competence byly zrušeny
(Beta) API CDK nyní obsahuje diginální kompetence /cdk/digi api bude stabilizováno v Q1 2021