# API Profil de poste
Skilvioo met à disposition son API profil de poste afin de permettre aux entreprises de gérer leur cartographie compétences dans leur organisation. Cette cartographie est définie d'une part, par les compétences des individus (salariés, candidats...) et d'autre part par les compétences requises pour chaque profil de poste.

Skilvioo dispose d'un **référentiel commun de compétences** que l'on appelle **Thesaurus**
Ce thesaurus répertorie plus de 12 000 métiers, 1 100 diplômes. On appelle ces métiers et diplômes dans "clusters" car ils sont tous déclinés en **ressources**.
Une ressource est le niveau le plus fin et atomique de la définition d'une compétence. Une ressource peut ainsi être un **savoir**, un **savoir faire**, ou un **savoir être**
Le thesaurus dispose d'au total de plus de 17 000 ressources et est régulièrement tenu à jour.

Grâce à ce référentiel qui vous est mis à disposition, vous pouvez construire les profils compétences de vos salariés, et de vos postes.

Cette API est découpée en 4 modules :
- Search
- Position Skill Profile
- Person Skill Profile
- Matching

## Module Search
L'ensemble des endpoints de ce module vous permet d'explorer et d'exploiter le référentiel. Le point d'entrée principal est la recherche.
C'est le endpoint ```/thesaurus``` qui vous permet d'effectuer une recherche dans notre thesaurus. Les résultats seront paginés (par 10) et triés par ordre de pertinence selon vos mots clés. Vous pouvez utiliser des filtres pour ne recevoir par exemple que des métiers, ou compétences ou que des savoir être.
Le endpoint `/resourceClusters/{{clusterId}}` vous permet d'explorer un métier ou une formation en particulier.
Le endpoint ```/resource/resourceId``` vous permet d'avoir les détails d'une ressource cible.

## Module Position Skill Profile
Ce module vous permet de gérer vos profils de postes.
Vous pouvez via les endpoints proposés, créer, modifier supprimer des profils de poste et les alimenter en ressources.

## Module Person Skill Profile
Ce module vous permet de gérer les compétences de vos individus.
Vous pouvez via les endpoints proposés, créer, modifier supprimer des profils de compétences d'individus et les alimenter en ressources. Vous noterez que nous demandons aucune donnée personnelle propre à l'individu concerné, ainsi les profils de compétences sont de notre coté anonymes. Livre à vous d'implémenter une solution pour lier un profil compétence à une personne cible.

## Module Matching
Ce module vous permet d'accéder à nos services de Matching compétences. Ces services exploitent des algorithmes qui définissent un score de matching entre un cluster et un autre par exemple.
Voici les différents matching proposés:
- Matching d'un profil compétences d'une personne plusieurs métiers (top 10)
- Matching d'un profil compétences d'une personne tous vos profils de postes
- Matching d'un profil de poste vers plusieurs métiers (top 10)
- Matching d'un profil de poste vers tous vos profils compétences de vos personnes
- Matching d'un profil de poste vers un profil compétences d'une personne (renvoit le score de matching)