Lister les appellations

Présentation

Cette ressource permet de lister les appellations. Il est possible de rechercher une liste d’appellations depuis une liste de codes, les codes inexistants étant ignorés.

 

Description de la requête

Point d'accès

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

 

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 5

Codes des appellations 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 les champs suivants :
  • code ROME du métier de l'appellation
  • libellé de l'appellation

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).

qf

0..1 String

Permet de préciser sur quel(s) champ(s) la recherche doit s'effectuer. Si non renseigné, la recherche s'effectue sur les deux champs.

Valeurs possibles :

  • libelle → libellé de l'appellation
  • metier(code) → code ROME du métier de l'appellation

 

 

Exemples d'appel

GET https://api.emploi-store.fr/partenaire/rome/v1/appellation?q=ing%20agro

Authorization: Bearer [Access token]

 

GET https://api.emploi-store.fr/partenaire/rome/v1/appellation?code=11579&code=13821&code=18088

Authorization: Bearer [Access token]

 

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

Authorization: Bearer [Access token]

 

Description de la réponse

Données retournées

Code Cardinalité Format Description
  0..n Tableau Liste des appellations
code 1 String 5 Code de l'appellation
libelle 1 String Libellé de l'appellation
libelleCourt 0..1 String Libellé court de l'appellation
particulier 1 Booléen Indique si l'appellation est éligible pour un particulier employeur

 

Exemple de retour

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

[
    {...},
    {
        "code": "38877",
        "libelle": "Conducteur / Conductrice d'épareuse",
        "libelleCourt": "Conducteur / Conductrice d'épareuse",
        "particulier": false
    },
    {...}
]

 

Cas d'erreurs possibles

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