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
Authorization	Bearer [Access token]
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.