API Match via Soft Skills v1

Présentation

L'API Match via Soft Skills restitue la liste des qualités comportementales classées par niveau d'importance pour un métier (code ROME).

Le niveau d'importance correspond à un score de 0 à 1 issu d'algorithmes et de données collectées par Instarlink. Il indique l'importance d'avoir la compétence comportementale pour le métier recherché.

 

Caractéristiques

Mode d'accès public
Fréquence de mise à jour

temps réel

Cinématique OAuth client credentials grant
Royaume Pôle Emploi Access Management /partenaire
Scopes nécessaires

 

Description de la requête

Point d'accès

POST https://api.emploi-store.fr/partenaire/matchviasoftskills/v1/professions/job_skills

 

Paramètres d'entrée

En-tête(s) Valeur
Accept application/json
Code Cardinalité Format Description
code

1,1

String 5

Code ROME du métier

Référentiel : Métiers ROME

 

Exemple d'appel

POST https://api.emploi-store.fr/partenaire/matchviasoftskills/v1/professions/job_skills?code=A1201

Authorization: Bearer [Access token]

 

Description de la réponse

L'API retourne une liste de 23 compétences triées par ordre de score pour un métier donné. Plus le score est élevé, plus la compétence est requise pour le métier recherché.

Données retournées

Code Cardinalité Format Description
uuid 1,1 String 36 Identifiant de la réponse
created_at 1,1 Date

Date de la réponse

Norme ISO-8601 (YYYY-MM-DDTHH:MM:SSZ)

code 1,1 String 5 Code ROME
skills 23,23 Sous balise

Liste des compétences

skills.soft_skill_[n] 1,1 Sous balise Détail de la compétence
skills.soft_skill_[n].summary 1,1 String 75 Libellé de la compétence
skills.soft_skill_[n].details 1,1 String 250 Descriptif de la compétence
skills.soft_skill_[n].score 1,1 Double

Score de la compétence

Valeur entre 0 et 1

 

Exemple de retour

HTTP 201 Created
Content-Type: application/json;charset=UTF-8

{
    "uuid": "0e1632c2-80e3-4540-9329-4c423e056063",
    "code": "A1201",
    "created_at": "2017-07-21T15:06:17Z",
    "skills": {
        "soft_skill_12": {
            "score": 1,
            "summary": "Sens de la pédagogie",
            "details": "Exprimer avec clarté, expliquer et transmettre une information, une réglementation, une procédure ou un processus."
        },
        "soft_skill_11": {
            "score": 1,
            "summary": "Être rigoureux",
            "details": "Prêter attention aux détails, avoir le souci de la vérification et du contrôle en vue de réduire les incertitudes dans son action et dans son environnement."
        },
        "soft_skill_16": {
            "score": 1,
            "summary": "Sens des affaires et de la valeur de l’argent",
            "details": "Renvoie à la capacité d’empathie et d’analyse de l’environnement pour vendre et faire des affaires au mieux permis par les événements."
        },
        "soft_skill_09": {
            "score": 0.926516042330088,
            "summary": "Sens de l’organisation",
            "details": "Avoir une propension à agencer et structurer son environnement en vue d’optimiser le service rendu."
        },
        {…}
    }
}

 

Cas d'erreurs possibles

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