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	api_matchviasoftskillsv1 application_`Votre identifiant client`

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

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.