Rechercher un métier ou une compétence

Présentation

Cette ressource permet de réaliser une recherche de métiers ou de compétences à partir de critères de sélection.

Description de la requête

Point d'accès

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

 

Paramètres d'entrée

En-tête(s) Valeur
Authorization

Bearer [Access token]
Code Cardinalité Format Description
libelle 1 String

Libelle de la saisie à rechercher
nombre 0..1 Integer

Nombre de résultat à retourner
type 0..1 String

Le type de recherche à effectuer

Valeurs possibles :

  • metier ? Le service ne retournera que des métiers
  • competence ? Le service ne retournera que des compétences

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/explorateurmetiers/v1/explorateurmetiers?libelle=com&nombre=20&type=metier
Authorization: Bearer [Access token]

 

Description de la réponse

Données retournées

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

metierCompetence */ x

où

  • x est le nombre total d’éléments de la recherche
Code Cardinalité Format Description
libelle 1 String Libellé du métier ou compétence
reference 1 String Référence
score 1 Float Score du matching
typeReference 1 String Type de la recherche

 

Exemple de retour

HTTP 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
[
    {
        "libelle": "Comédien / Comédienne",
        "reference": "12724",
        "score": 1.7049346,
        "typeReference": "metier"
    },
    {
        "libelle": "Commandant / Commandante marine",
        "reference": "12737",
        "score": 1.6734178,
        "typeReference": "metier"
    }
{..}

 

 Cas d'erreurs possibles

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