API Jobs&Skills v1

Présentation

L'API Jobs&Skills permet de faire de la recherche de métiers, de compétences, d’activités, etc. pour de l’autocomplétion.

Elle donne accès à plus de 50 000 concepts en français et dans cinq autres langues, issus du référentiel MindMatcher composé de référentiels d’autorité (ROME, ESCO, etc.), de référentiels personnalisés d’entreprises et des suggestions des utilisateurs.

L’API Jobs&Skills vous permet d’exposer des services à vos utilisateurs basés sur un référentiel complet qui intègre de nombreuses sources de compétences.

 

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

GET https://api.emploi-store.fr/partenaire/jobsandskills/v1/jobs-and-skills/suggest

 

Paramètres d'entrée

Code Cardinalité Format Description
query

0,1

String

Terme partiel recherché pour autocomplétion

size

0,1

String

Nombre de suggestions d'autocomplétion attendues

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/jobsandskills/v1/jobs-and-skills/suggest?query=avion&size=3

Authorization: Bearer [Access token]

 

Description de la réponse

L'API retourne une liste de concepts au format JSON correspondants à la demande d’autocomplétion.

La structuration de la réponse ainsi que son contenu peuvent être adaptés en fonction des besoins de la communauté. N’hésitez pas à nous faire part de vos remarques et suggestions depuis la page de contact.

 

Données retournées

Code Cardinalité Format Description
data 1,1 Sous balise

Parent de l’objet JSON, pas d’utilité fonctionnelle

data.concepts 1,1 Sous balise

Contenant des réponses fournies, pas d’utilité fonctionnelle

data.concepts.edges 1,1 Tableau (0..n)

Tableau contenant l’ensemble des concepts associés à la recherche

data.concepts.edges.node 1,1 Sous balise

Contenant pour les propriétés des concepts suggérés

data.concepts.edges.node.id 1,1 Integer

Identifiant unique du concept dans la base MindMatcher

data.concepts.edges.node.prefLabel 1,1 String

Terme principal utilisé pour le concept en français

Les synonymes ainsi que les traductions peuvent être mis à disposition sur demande

data.concepts.edges.node.scheme 1,1 Sous balise

Contenant pour l’identification du type de concept

Permet de déterminer si il s’agit d’un terme faisant référence à un métier, une compétence ou une activité du référentiel ROME ou de sa nature dans un autre référentiel présent dans la base MindMatcher (exemple : ESCO)

data.concepts.edges.node.scheme.title 1,1 String

Libellé en français du type de concept

data.concepts.edges.node.scheme.id 1,1 String

Identifiant unique du type de concept

 

Exemple de retour

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

{
    "data": {
        "concepts": {
            "edges": [
                {
                    "node": {
                        "id": "Q29uY2VwdDpDb25jZXB0OjMwMzYwODE5MjoxNjEzMg==",
                        "prefLabel": "technicien avionique/technicienne avionique",
                        "scheme": {
                            "title": "Métiers",
                            "id": "U2NoZW1lOlNjaGVtZToxNzQ1NTY0MDMyOjE1OTg4"
                        }
                    }
                },
                {
                    "node": {
                        "id": "Q29uY2VwdDpDb25jZXB0OjE0MzQ0MDAyNTY6MTUyMDM=",
                        "prefLabel": "technicien aéronautique/technicienne aéronautique",
                        "scheme": {
                            "title": "Métiers",
                            "id": "U2NoZW1lOlNjaGVtZTo1MzM2Mjc2NDg6MTU5Njg="
                        }
                    }
                },
                {
                    "node": {
                        "id": "Q29uY2VwdDpDb25jZXB0OjkxNzQ4OTI4MDoxNjM1NA==",
                        "prefLabel": "agent de nettoyage avion/agente de nettoyage avion",
                        "scheme": {
                            "title": "Métiers",
                            "id": "U2NoZW1lOlNjaGVtZTo1MzM2Mjc2NDg6MTU5Njg="
                        }
                    }
                }
            ]
        }
    }
}

 

Cas d'erreurs possibles

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