Lister les compétences

Présentation

Cette ressource permet de lister les compétences. Il est possible de filtrer les compétences suivant leurs types. De plus, lorsque le type de compétence n’est pas renseigné ou est renseigné et valorisé à savoir-faire, il est possible de filtrer les compétences suivant le RIASEC majeur, le RIASEC mineur ou les deux. Enfin, il est possible de rechercher une liste de compétences depuis une liste de codes, les codes inexistants étant ignorés. Lorsqu’une liste de codes est renseignée, aucun autre filtre n’est autorisé.

Description de la requête

Point d'accès

GET https://api.emploi-store.fr/partenaire/rome/v1/competence

Paramètres d'entrée

En-tête(s)	Valeur
Content-Type	application/json
Accept	application/json

Code	Cardinalité	Format	Description
code	0..n	String 6	Codes des compétences recherchées
q	0..1	String	Ensemble de mots, complets ou partiels, sur lesquels la recherche s'effectue. Les résultats sont triés par pertinence, celle-ci étant calculée suivant le libellé de la compétence.
op	0..1	String	Valeurs possibles : `AND` → chacun des mots doit avoir une correspondance dans les champs sur lesquels s'effectue la recherche `OR` → au moins un mot doit avoir une correspondance dans les champs sur lesquels s'effectue la recherche (par défaut)
riasecmajeur	0..1	String 1	RIASEC majeur. Interdit si typecompetence est renseigné et valorisé à Savoir. Valeurs possibles : `R` → Réaliste `I` → Investigateur `A` → Artistique `S` → Social `E` → Entreprenant `C` → Conventionnel
riasecmineur	0..1	String 1	RIASEC mineur. Interdit si typecompetence est renseigné et valorisé à Savoir. Valeurs possibles : `R` → Réaliste `I` → Investigateur `A` → Artistique `S` → Social `E` → Entreprenant `C` → Conventionnel
typecompetence	0..1	String	Type de compétence Valeurs possibles : `Savoir` `SavoirFaire`

Exemples d'appel

GET https://api.emploi-store.fr/partenaire/rome/v1/competence?q=cuisine

Authorization: Bearer [Access token]

GET https://api.emploi-store.fr/partenaire/rome/v1/competence?code=103659&code=119943&code=12213

Authorization: Bearer [Access token]

GET https://api.emploi-store.fr/partenaire/rome/v1/competence

Authorization: Bearer [Access token]

Description de la réponse

Données retournées

Code	Cardinalité	Format	Description
	0..n	Compétences	Liste des compétences

Exemple de retour

HTTP 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

[
    {...},
    {
        "code": "125978",
        "libelle": "Préparer le matériel, les matériaux et les outillages",
        "noeudCompetence": {
            "code": "00173",
            "libelle": "Manipulation des outils et des équipements",
            "racineCompetence": {
                "code": "00007",
                "libelle": "Compétences transverses"
            }
        },
        "typeCompetence": "SavoirFaire",
        "riasecMineur": "R",
        "riasecMajeur": "R"
    },
    {...}
]

Cas d'erreurs possibles

Retrouvez la liste des cas d'erreurs possibles sur la page Erreurs Types.