{ "openapi": "3.0.1", "info": { "version": "1", "title": "ROME 4.0 - Compétences", "description": "Référentiel des capacités, ou des ensembles de connaissances, d'aptitudes, d'attitudes et de comportements, qui permettent à une personne d'accomplir une tâche ou de résoudre un problème de manière efficace.
Une compétence désigne la capacité à agir dans une situation professionnelle donnée, en mobilisant et en combinant des ressources telles que:
\r\n\r\n**Scopes** : `api_rome-competencesv1`,`nomenclatureRome`\r\n\r\n**Royaume** : `/partenaire`" }, "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences" } ], "paths": { "/v1/competences/categorie-savoirs": { "get": { "tags": [ "Catégorie de savoirs" ], "summary": "Lister les catégories de savoirs", "description": "Permet d'obtenir la liste des catégories de savoirs.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerCategorieSavoirs", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "categorie(libelle,code)", "code", "datefin", "libelle", "obsolete", "savoirs(libelle,code,transitionecologique,transitionnumerique,codeogr)", "souscategories(libelle,code)" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des catégories de savoir.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CategorieSavoir" } }, "examples": { "Retour complet": { "value": [ { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "sousCategories": [ { "libelle": "Véhicules", "code": "30" } ], "obsolete": false, "code": "30", "savoirs": [ { "type": "SAVOIR", "libelle": "Anglais maritime", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "dateFin": "2024-02-23T14:40:14.848Z" } ] }, "Retour par défaut": { "value": [ { "libelle": "Véhicules", "code": "30" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/categorie-savoirs/{code}": { "get": { "tags": [ "Catégorie de savoirs" ], "summary": "Lire une catégorie de savoirs", "description": "Permet de lire une catégorie de savoirs depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireCategorieSavoir", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "categorie(libelle,code)", "code", "datefin", "libelle", "obsolete", "savoirs(libelle,code,transitionecologique,transitionnumerique,codeogr)", "souscategories(libelle,code)" ], "example": "libelle,categorie(libelle,code),obsolete,code,datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code de la catégorie de savoirs.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données d'une catégorie de savoir.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CategorieSavoir" }, "examples": { "Retour complet": { "value": { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "sousCategories": [ { "libelle": "Véhicules", "code": "30" } ], "obsolete": false, "code": "30", "savoirs": [ { "type": "SAVOIR", "libelle": "Anglais maritime", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "obsolete": false, "code": "30", "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/competence": { "get": { "tags": [ "Compétence" ], "summary": "Lister les compétences", "description": "Permet de lister les compétences au sens général.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerCompetences", "parameters": [ { "name": "code-ogr", "in": "query", "description": "Code OGR.", "required": false, "schema": { "type": "string" } }, { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "@competencedetaillee(riasecmineur,macrocompetence(libelle,transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,code,riasecmineur,codearborescence,objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence),codeogr,maturite,riasecmajeur),riasecmajeur)", "@macrocompetence(transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,riasecmineur,codearborescence,objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence),maturite,riasecmajeur)", "@savoir(categoriesavoir(libelle,categorie(libelle,code),code))", "code", "codeogr", "competenceesco(libelle,uri)", "datefin", "libelle", "obsolete", "transitionecologique", "transitionnumerique" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des compétences.", "content": { "application/json": { "schema": { "type": "array", "items": { "oneOf": [ { "$ref": "#/components/schemas/CompetenceDetaillee" }, { "$ref": "#/components/schemas/MacroCompetence" }, { "$ref": "#/components/schemas/Savoir" } ] } }, "examples": { "Retour complet": { "value": [ { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "macroCompetence": { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R" }, "riasecMajeur": "R", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "maturite": "HETEROGENE", "categorieSavoir": { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "code": "30" }, "dateFin": "2024-02-23T14:40:14.848Z" } ] }, "Retour par défaut": { "value": [ { "type": "string", "libelle": "Anglais maritime", "code": "100253" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/competence-detaillee": { "get": { "tags": [ "Compétence détaillée" ], "summary": "Lister les compétences", "description": "Permet de lister les compétences de type compétences détaillées.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerCompetencesDetaillees", "parameters": [ { "name": "code-ogr", "in": "query", "description": "Code OGR.", "required": false, "schema": { "type": "string" } }, { "name": "riasec-majeur", "in": "query", "description": "Riasec majeur.", "required": false, "schema": { "type": "string" } }, { "name": "riasec-mineur", "in": "query", "description": "Riasec mineur.", "required": false, "schema": { "type": "string" } }, { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codeogr", "competenceesco(libelle,uri)", "datefin", "libelle", "macrocompetence(libelle,transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,code,riasecmineur,codearborescence,objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence),codeogr,maturite,riasecmajeur)", "obsolete", "riasecmajeur", "riasecmineur", "transitionecologique", "transitionnumerique" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des compétences détaillées.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CompetenceDetaillee" } }, "examples": { "Retour complet": { "value": [ { "type": "COMPETENCE-DETAILLEE", "libelle": "Anglais maritime", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "riasecMineur": "R", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "macroCompetence": { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R" }, "riasecMajeur": "R", "dateFin": "2024-02-23T14:40:14.848Z" } ] }, "Retour par défaut": { "value": [ { "type": "COMPETENCE-DETAILLEE", "libelle": "Anglais maritime", "code": "100253" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/competence-detaillee/{code}": { "get": { "tags": [ "Compétence détaillée" ], "summary": "Lire une compétence détaillée", "description": "Permet la lecture d'une compétence de type compétence détaillée depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireCompetenceDetaillee", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codeogr", "competenceesco(libelle,uri)", "datefin", "libelle", "macrocompetence(libelle,transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,code,riasecmineur,definition,codearborescence,objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence),codeogr,maturite,riasecmajeur)", "obsolete", "riasecmajeur", "riasecmineur", "transitionecologique", "transitionnumerique" ], "example": "libelle,obsolete,code,competenceesco(libelle,uri),riasecmineur,transitionecologique,transitionnumerique,codeogr,macrocompetence(libelle,transferable,souscategorie,code,riasecmineur,definition,codeogr,maturite,riasecmajeur,@macrosavoiretreprofessionnel(qualiteprofessionnelle),codearborescence,objectif(codearborescence,libelle,enjeu(codearborescence,libelle,code,domainecompetence(codearborescence,libelle,code)),code)),riasecmajeur,datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code compétence.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données de la compétence détaillée renseignée.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompetenceDetaillee" }, "examples": { "Retour complet": { "value": { "type": "COMPETENCE-DETAILLEE", "libelle": "Anglais maritime", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "riasecMineur": "R", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "macroCompetence": { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "definition": "string", "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R" }, "riasecMajeur": "R", "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "type": "COMPETENCE-DETAILLEE", "libelle": "Anglais maritime", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "riasecMineur": "R", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "macroCompetence": { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "definition": "string", "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "qualiteProfessionnelle": "01", "codeArborescence": "string", "objectif": { "codeArborescence": "1E4", "libelle": "Soigner des animaux", "enjeu": { "codeArborescence": "1E", "libelle": "Soin", "code": "7", "domaineCompetence": { "codeArborescence": "1", "libelle": "Management, Social, Soin", "code": "1" } }, "code": "19" } }, "riasecMajeur": "R", "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/competence/{code}": { "get": { "tags": [ "Compétence" ], "summary": "Lire une compétence", "description": "Permet la lecture d'une compétence depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireCompetence", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "@competencedetaillee(riasecmineur,macrocompetence(libelle,transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,code,riasecmineur,definition,codearborescence,objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence),codeogr,maturite,riasecmajeur),riasecmajeur)", "@macrocompetence(competences(libelle,@competencedetaillee(riasecmineur,riasecmajeur),code,transitionecologique,transitionnumerique,codeogr,@macrocompetence(riasecmineur,riasecmajeur)),transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,riasecmineur,definition,codearborescence,objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence),maturite,riasecmajeur)", "@savoir(categoriesavoir(libelle,categorie(libelle,code),code))", "code", "codeogr", "competenceesco(libelle,uri)", "datefin", "libelle", "obsolete", "transitionecologique", "transitionnumerique" ], "example": "libelle,@competencedetaillee(macrocompetence(libelle,transferable,souscategorie,code,riasecmineur,definition,codeogr,maturite,riasecmajeur,@macrosavoiretreprofessionnel(qualiteprofessionnelle),codearborescence,objectif(codearborescence,libelle,enjeu(codearborescence,libelle,code,domainecompetence(codearborescence,libelle,code)),code)),riasecmajeur,riasecmineur),obsolete,code,competenceesco(libelle,uri),transitionecologique,transitionnumerique,codeogr,@macrocompetence(transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,riasecmineur,definition,codearborescence,objectif(codearborescence,libelle,enjeu(codearborescence,libelle,code,domainecompetence(codearborescence,libelle,code)),code),maturite,riasecmajeur),@savoir(categoriesavoir(libelle,categorie(libelle,code),code)),datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code compétence.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données de la compétence renseignée.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/CompetenceDetaillee" }, { "$ref": "#/components/schemas/MacroCompetence" }, { "$ref": "#/components/schemas/Savoir" } ] }, "examples": { "Retour complet": { "value": { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "macroCompetence": { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "definition": "string", "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R" }, "riasecMajeur": "R", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "competences": [ { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "riasecMajeur": "R", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "definition": "string", "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "maturite": "HETEROGENE", "categorieSavoir": { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "code": "30" }, "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "type": "string", "libelle": "Anglais maritime", "macroCompetence": { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "definition": "string", "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "qualiteProfessionnelle": "01", "codeArborescence": "string", "objectif": { "codeArborescence": "1E4", "libelle": "Soigner des animaux", "enjeu": { "codeArborescence": "1E", "libelle": "Soin", "code": "7", "domaineCompetence": { "codeArborescence": "1", "libelle": "Management, Social, Soin", "code": "1" } }, "code": "19" } }, "riasecMajeur": "R", "riasecMineur": "R", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "definition": "string", "codeArborescence": "string", "objectif": { "codeArborescence": "1E4", "libelle": "Soigner des animaux", "enjeu": { "codeArborescence": "1E", "libelle": "Soin", "code": "7", "domaineCompetence": { "codeArborescence": "1", "libelle": "Management, Social, Soin", "code": "1" } }, "code": "19" }, "maturite": "HETEROGENE", "categorieSavoir": { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "code": "30" }, "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/domaine-competence": { "get": { "tags": [ "Domaine de compétence" ], "summary": "Lister les domaines de compétence", "description": "Permet de lister les domaines de compétence.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerDomainesCompetence", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "datefin", "enjeux(objectifs(libelle,macrocompetences(libelle,transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,code,riasecmineur,codearborescence,transitionecologique,transitionnumerique,codeogr,maturite,riasecmajeur),code,codearborescence),libelle,code,codearborescence)", "libelle", "obsolete" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des domaines de compétence.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DomaineCompetence" } }, "examples": { "Retour complet": { "value": [ { "libelle": "Management, Social, Soin", "obsolete": false, "code": "1", "codeArborescence": "1", "enjeux": [ { "objectifs": [ { "libelle": "Soigner des animaux", "macroCompetences": [ { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "codeArborescence": "string", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R" } ], "code": "19", "codeArborescence": "1E4" } ], "libelle": "Soin", "code": "7", "codeArborescence": "1E" } ], "dateFin": "2024-02-23T14:40:14.848Z" } ] }, "Retour par défaut": { "value": [ { "libelle": "Management, Social, Soin", "code": "1" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/domaine-competence/{code}": { "get": { "tags": [ "Domaine de compétence" ], "summary": "Lire un domaine de compétence", "description": "Permet la lecture d'un domaine de compétence depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireDomaineCompetence", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "datefin", "enjeux(objectifs(libelle,macrocompetences(libelle,transferable,souscategorie,code,riasecmineur,transitionnumerique,codeogr,maturite,riasecmajeur,competences(libelle,@competencedetaillee(riasecmineur,riasecmajeur),code,transitionecologique,transitionnumerique,codeogr,@macrocompetence(riasecmineur,riasecmajeur)),@macrosavoiretreprofessionnel(qualiteprofessionnelle),codearborescence,transitionecologique),code,codearborescence),libelle,code,codearborescence)", "libelle", "obsolete" ], "example": "libelle,obsolete,code,codearborescence,datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code du domaine de compétence.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données du domaine de compétence renseigné.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DomaineCompetence" }, "examples": { "Retour complet": { "value": { "libelle": "Management, Social, Soin", "obsolete": false, "code": "1", "codeArborescence": "1", "enjeux": [ { "objectifs": [ { "libelle": "Soigner des animaux", "macroCompetences": [ { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "competences": [ { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "riasecMajeur": "R", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "qualiteProfessionnelle": "01", "codeArborescence": "string", "transitionEcologique": false } ], "code": "19", "codeArborescence": "1E4" } ], "libelle": "Soin", "code": "7", "codeArborescence": "1E" } ], "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "libelle": "Management, Social, Soin", "obsolete": false, "code": "1", "codeArborescence": "1", "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/enjeu": { "get": { "tags": [ "Enjeu de compétences" ], "summary": "Lister les enjeux de compétences", "description": "Permet de lister les enjeux de compétences.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerEnjeux", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "datefin", "domainecompetence(libelle,code,codearborescence)", "libelle", "objectifs(libelle,macrocompetences(libelle,transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,code,riasecmineur,codearborescence,transitionecologique,transitionnumerique,codeogr,maturite,riasecmajeur),code,codearborescence)", "obsolete" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des enjeux de compétences.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Enjeu" } }, "examples": { "Retour complet": { "value": [ { "objectifs": [ { "libelle": "Soigner des animaux", "macroCompetences": [ { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "codeArborescence": "string", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R" } ], "code": "19", "codeArborescence": "1E4" } ], "libelle": "Soin", "obsolete": false, "code": "7", "codeArborescence": "1E", "dateFin": "2024-02-23T14:40:14.848Z", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } } ] }, "Retour par défaut": { "value": [ { "libelle": "Soin", "code": "7" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/enjeu/{code}": { "get": { "tags": [ "Enjeu de compétences" ], "summary": "Lire un enjeu de compétences", "description": "Permet la lecture d'un enjeu de compétences depuis son code\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireEnjeu", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "datefin", "domainecompetence(libelle,code,codearborescence)", "libelle", "objectifs(libelle,macrocompetences(libelle,transferable,souscategorie,code,riasecmineur,transitionnumerique,codeogr,maturite,riasecmajeur,competences(libelle,@competencedetaillee(riasecmineur,riasecmajeur),code,transitionecologique,transitionnumerique,codeogr,@macrocompetence(riasecmineur,riasecmajeur)),@macrosavoiretreprofessionnel(qualiteprofessionnelle),codearborescence,transitionecologique),code,codearborescence)", "obsolete" ], "example": "libelle,obsolete,code,codearborescence,datefin,domainecompetence(codearborescence,libelle,code)" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code enjeu.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données pour un enjeu de compétences renseigné.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Enjeu" }, "examples": { "Retour complet": { "value": { "objectifs": [ { "libelle": "Soigner des animaux", "macroCompetences": [ { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "competences": [ { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "riasecMajeur": "R", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "qualiteProfessionnelle": "01", "codeArborescence": "string", "transitionEcologique": false } ], "code": "19", "codeArborescence": "1E4" } ], "libelle": "Soin", "obsolete": false, "code": "7", "codeArborescence": "1E", "dateFin": "2024-02-23T14:40:14.848Z", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } } }, "Retour par défaut": { "value": { "libelle": "Soin", "obsolete": false, "code": "7", "codeArborescence": "1E", "dateFin": "2024-02-23T14:40:14.848Z", "domaineCompetence": { "codeArborescence": "1", "libelle": "Management, Social, Soin", "code": "1" } } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/macro-competence": { "get": { "tags": [ "Macro-compétence" ], "summary": "Lister les macro-compétences", "description": "Permet de lister les macro-compétences.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerMacroCompetences", "parameters": [ { "name": "code-ogr", "in": "query", "description": "Code OGR.", "required": false, "schema": { "type": "string" } }, { "name": "riasec-majeur", "in": "query", "description": "Riasec majeur.", "required": false, "schema": { "type": "string" } }, { "name": "riasec-mineur", "in": "query", "description": "Riasec mineur.", "required": false, "schema": { "type": "string" } }, { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "@macrosavoiretreprofessionnel(qualiteprofessionnelle)", "code", "codearborescence", "codeogr", "competenceesco(libelle,uri)", "datefin", "definition", "libelle", "maturite", "objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence)", "obsolete", "riasecmajeur", "riasecmineur", "souscategorie", "transferable", "transitionecologique", "transitionnumerique" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des macro-compétences.", "content": { "application/json": { "schema": { "type": "array", "items": { "oneOf": [ { "$ref": "#/components/schemas/MacroSavoirEtreProfessionnel" }, { "$ref": "#/components/schemas/MacroSavoirFaire" } ] } }, "examples": { "Retour complet": { "value": [ { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "qualiteProfessionnelle": "01", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } ] }, "Retour par défaut": { "value": [ { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "code": "100253" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/macro-competence/{code}": { "get": { "tags": [ "Macro-compétence" ], "summary": "Lire une macro-compétence", "description": "Permet la lecture d'une macro-compétence depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireMacroCompetence", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "@macrosavoiretreprofessionnel(qualiteprofessionnelle)", "code", "codearborescence", "codeogr", "competenceesco(libelle,uri)", "competences(libelle,@competencedetaillee(riasecmineur,riasecmajeur),code,transitionecologique,transitionnumerique,codeogr,@macrocompetence(riasecmineur,riasecmajeur))", "datefin", "definition", "libelle", "maturite", "objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence)", "obsolete", "riasecmajeur", "riasecmineur", "souscategorie", "transferable", "transitionecologique", "transitionnumerique" ], "example": "libelle,transferable,souscategorie,obsolete,code,riasecmineur,definition,transitionnumerique,codeogr,maturite,riasecmajeur,@macrosavoiretreprofessionnel(qualiteprofessionnelle),competenceesco(libelle,uri),codearborescence,objectif(codearborescence,libelle,enjeu(codearborescence,libelle,code,domainecompetence(codearborescence,libelle,code)),code),transitionecologique,datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code macro-compétence.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données pour une macro-compétence renseignée.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/MacroSavoirEtreProfessionnel" }, { "$ref": "#/components/schemas/MacroSavoirFaire" } ] }, "examples": { "Retour complet": { "value": { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "competences": [ { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "riasecMajeur": "R", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "qualiteProfessionnelle": "01", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "qualiteProfessionnelle": "01", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "codeArborescence": "1E4", "libelle": "Soigner des animaux", "enjeu": { "codeArborescence": "1E", "libelle": "Soin", "code": "7", "domaineCompetence": { "codeArborescence": "1", "libelle": "Management, Social, Soin", "code": "1" } }, "code": "19" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/macro-savoir-faire": { "get": { "tags": [ "Macro-savoir-faire" ], "summary": "Lister les macros savoir-faire", "description": "Permet de lister les macros savoir-faire.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerMacroSavoirFaires", "parameters": [ { "name": "code-ogr", "in": "query", "description": "Code OGR.", "required": false, "schema": { "type": "string" } }, { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "codeogr", "competenceesco(libelle,uri)", "datefin", "definition", "libelle", "maturite", "objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence)", "obsolete", "riasecmajeur", "riasecmineur", "souscategorie", "transferable", "transitionecologique", "transitionnumerique" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des macros savoir-faire.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MacroSavoirFaire" } }, "examples": { "Retour complet": { "value": [ { "type": "MACRO-SAVOIR-FAIRE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } ] }, "Retour par défaut": { "value": [ { "type": "MACRO-SAVOIR-FAIRE", "libelle": "Anglais maritime", "code": "100253" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/macro-savoir-faire/{code}": { "get": { "tags": [ "Macro-savoir-faire" ], "summary": "Lire une macro savoir-faire", "description": "Permet la lecture d'un macro savoir-faire depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireMacroSavoirFaire", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "codeogr", "competenceesco(libelle,uri)", "competences(libelle,@competencedetaillee(riasecmineur,riasecmajeur),code,transitionecologique,transitionnumerique,codeogr,@macrocompetence(riasecmineur,riasecmajeur))", "datefin", "definition", "libelle", "maturite", "objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence)", "obsolete", "riasecmajeur", "riasecmineur", "souscategorie", "transferable", "transitionecologique", "transitionnumerique" ], "example": "libelle,transferable,souscategorie,obsolete,code,riasecmineur,definition,transitionnumerique,codeogr,maturite,riasecmajeur,competenceesco(libelle,uri),codearborescence,objectif(codearborescence,libelle,enjeu(codearborescence,libelle,code,domainecompetence(codearborescence,libelle,code)),code),transitionecologique,datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code macro savoir-faire.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données pour un macro savoir-faire.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MacroSavoirFaire" }, "examples": { "Retour complet": { "value": { "type": "MACRO-SAVOIR-FAIRE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "competences": [ { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "riasecMajeur": "R", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "type": "MACRO-SAVOIR-FAIRE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "codeArborescence": "1E4", "libelle": "Soigner des animaux", "enjeu": { "codeArborescence": "1E", "libelle": "Soin", "code": "7", "domaineCompetence": { "codeArborescence": "1", "libelle": "Management, Social, Soin", "code": "1" } }, "code": "19" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/macro-savoir-etre-professionnel": { "get": { "tags": [ "Macro-savoir-être professionnel" ], "summary": "Lister les macros savoir-être professionnel", "description": "Permet de lister les macros savoir-être professionnels.\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerMacroSavoirEtreProfessionnels", "parameters": [ { "name": "code-ogr", "in": "query", "description": "Code OGR.", "required": false, "schema": { "type": "string" } }, { "name": "qualite-professionnelle", "in": "query", "description": "code qualité professionnelle.", "required": false, "schema": { "type": "string" } }, { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "codeogr", "competenceesco(libelle,uri)", "datefin", "definition", "libelle", "maturite", "objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence)", "obsolete", "qualiteprofessionnelle", "riasecmajeur", "riasecmineur", "souscategorie", "transferable", "transitionecologique", "transitionnumerique" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Ok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MacroSavoirEtreProfessionnel" }, "examples": { "Retour complet": { "value": { "type": "MACRO-SAVOIR-ETRE-PROFESSIONNEL", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "qualiteProfessionnelle": "01", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "type": "MACRO-SAVOIR-ETRE-PROFESSIONNEL", "libelle": "Anglais maritime", "code": "100253" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } }, "text/csv": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/macro-savoir-etre-professionnel/{code}": { "get": { "tags": [ "Macro-savoir-être professionnel" ], "summary": "Lire une macro savoir-être professionnel", "description": "Permet la lecture d'un macro savoir-être professionnel depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireMacroSavoirEtreProfessionnel", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "codeogr", "competenceesco(libelle,uri)", "competences(libelle,@competencedetaillee(riasecmineur,riasecmajeur),code,transitionecologique,transitionnumerique,codeogr,@macrocompetence(riasecmineur,riasecmajeur))", "datefin", "definition", "libelle", "maturite", "objectif(libelle,enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence)),code,codearborescence)", "obsolete", "qualiteprofessionnelle", "riasecmajeur", "riasecmineur", "souscategorie", "transferable", "transitionecologique", "transitionnumerique" ], "example": "libelle,transferable,souscategorie,obsolete,code,riasecmineur,definition,transitionnumerique,codeogr,maturite,riasecmajeur,qualiteprofessionnelle,competenceesco(libelle,uri),codearborescence,objectif(codearborescence,libelle,enjeu(codearborescence,libelle,code,domainecompetence(codearborescence,libelle,code)),code),transitionecologique,datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code macro savoir-être professionnel.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données pour un macro savoir-être professionel renseigné.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MacroSavoirEtreProfessionnel" }, "examples": { "Retour complet": { "value": { "type": "MACRO-SAVOIR-ETRE-PROFESSIONNEL", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "qualiteProfessionnelle": "01", "competences": [ { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "riasecMajeur": "R", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "code": "19", "codeArborescence": "1E4" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "type": "MACRO-SAVOIR-ETRE-PROFESSIONNEL", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "obsolete": false, "code": "100253", "riasecMineur": "R", "definition": "string", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "qualiteProfessionnelle": "01", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "codeArborescence": "string", "objectif": { "codeArborescence": "1E4", "libelle": "Soigner des animaux", "enjeu": { "codeArborescence": "1E", "libelle": "Soin", "code": "7", "domaineCompetence": { "codeArborescence": "1", "libelle": "Management, Social, Soin", "code": "1" } }, "code": "19" }, "transitionEcologique": false, "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/objectif": { "get": { "tags": [ "Objectif" ], "summary": "Lister les objectifs", "description": "Permet de lister les objectifs de compétences.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerObjectifs", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "datefin", "enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence))", "libelle", "macrocompetences(libelle,transferable,@macrosavoiretreprofessionnel(qualiteprofessionnelle),souscategorie,code,riasecmineur,codearborescence,transitionecologique,transitionnumerique,codeogr,maturite,riasecmajeur)", "obsolete" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des objectifs.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Objectif" } }, "examples": { "Retour complet": { "value": [ { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "macroCompetences": [ { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "qualiteProfessionnelle": "01", "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "codeArborescence": "string", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R" } ], "obsolete": false, "code": "19", "codeArborescence": "1E4", "dateFin": "2024-02-23T14:40:14.848Z" } ] }, "Retour par défaut": { "value": [ { "libelle": "Soigner des animaux", "code": "19" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/objectif/{code}": { "get": { "tags": [ "Objectif" ], "summary": "Lire un objectif", "description": "Permet la lecture d'un objectif depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireObjectif", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "code", "codearborescence", "datefin", "enjeu(libelle,code,codearborescence,domainecompetence(libelle,code,codearborescence))", "libelle", "macrocompetences(libelle,transferable,souscategorie,code,riasecmineur,transitionnumerique,codeogr,maturite,riasecmajeur,competences(libelle,@competencedetaillee(riasecmineur,riasecmajeur),code,transitionecologique,transitionnumerique,codeogr,@macrocompetence(riasecmineur,riasecmajeur)),@macrosavoiretreprofessionnel(qualiteprofessionnelle),codearborescence,transitionecologique)", "obsolete" ], "example": "libelle,enjeu(codearborescence,libelle,code,domainecompetence(codearborescence,libelle,code)),obsolete,code,codearborescence,datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code objectif.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données pour un objectif renseigné.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Objectif" }, "examples": { "Retour complet": { "value": { "libelle": "Soigner des animaux", "enjeu": { "libelle": "Soin", "code": "7", "codeArborescence": "1E", "domaineCompetence": { "libelle": "Management, Social, Soin", "code": "1", "codeArborescence": "1" } }, "macroCompetences": [ { "type": "MACRO-COMPETENCE", "libelle": "Anglais maritime", "transferable": false, "sousCategorie": "TECHNIQUE", "code": "100253", "riasecMineur": "R", "transitionNumerique": false, "codeOgr": "100253", "maturite": "HETEROGENE", "riasecMajeur": "R", "competences": [ { "type": "string", "libelle": "Anglais maritime", "riasecMineur": "R", "riasecMajeur": "R", "code": "100253", "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253" } ], "qualiteProfessionnelle": "01", "codeArborescence": "string", "transitionEcologique": false } ], "obsolete": false, "code": "19", "codeArborescence": "1E4", "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "libelle": "Soigner des animaux", "enjeu": { "codeArborescence": "1E", "libelle": "Soin", "code": "7", "domaineCompetence": { "codeArborescence": "1", "libelle": "Management, Social, Soin", "code": "1" } }, "obsolete": false, "code": "19", "codeArborescence": "1E4", "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/savoir": { "get": { "tags": [ "Savoir" ], "summary": "Lister les savoirs", "description": "Permet de lister les savoirs.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "listerSavoirs", "parameters": [ { "name": "code-ogr", "in": "query", "description": "Code OGR.", "required": false, "schema": { "type": "string" } }, { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "categoriesavoir(libelle,categorie(libelle,code),code)", "code", "codeogr", "competenceesco(libelle,uri)", "datefin", "libelle", "obsolete", "transitionecologique", "transitionnumerique" ], "example": "libelle,code" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne la liste des savoirs.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Savoir" } }, "examples": { "Retour complet": { "value": [ { "type": "SAVOIR", "libelle": "Anglais maritime", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "categorieSavoir": { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "code": "30" }, "dateFin": "2024-02-23T14:40:14.848Z" } ] }, "Retour par défaut": { "value": [ { "type": "SAVOIR", "libelle": "Anglais maritime", "code": "100253" } ] } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/savoir/{code}": { "get": { "tags": [ "Savoir" ], "summary": "Lire un savoir", "description": "Permet de lire un savoir depuis son code.\r\n\r\nSi vous renseignez une ou plusieurs valeurs dans \"champs\", alors vous obtiendrez le résultat pour ces champs.\r\n\r\nSi vous ne renseignez aucune valeur dans \"champs\", alors vous obtiendrez le résultat par défaut. (Sélectionner l'exemple \"***Par défaut***\" pour voir les données retournées)", "operationId": "lireSavoir", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "categoriesavoir(libelle,categorie(libelle,code),code)", "code", "codeogr", "competenceesco(libelle,uri)", "datefin", "libelle", "obsolete", "transitionecologique", "transitionnumerique" ], "example": "libelle,obsolete,code,competenceesco(libelle,uri),transitionecologique,transitionnumerique,codeogr,categoriesavoir(libelle,categorie(libelle,code),code),datefin" } }, { "name": "date", "in": "query", "description": "Date de la recherche au format yyyy-MM-dd ou yyyyMMdd.", "required": false, "schema": { "type": "string", "format": "date", "example": "2022-05-28" } }, { "name": "code", "in": "path", "description": "Code savoir.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "Retourne les données pour un savoir renseigné.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Savoir" }, "examples": { "Retour complet": { "value": { "type": "SAVOIR", "libelle": "Anglais maritime", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "categorieSavoir": { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "code": "30" }, "dateFin": "2024-02-23T14:40:14.848Z" } }, "Retour par défaut": { "value": { "type": "SAVOIR", "libelle": "Anglais maritime", "obsolete": false, "code": "100253", "competenceEsco": { "libelle": "abattre des arbres", "uri": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" }, "transitionEcologique": false, "transitionNumerique": false, "codeOgr": "100253", "categorieSavoir": { "libelle": "Véhicules", "categorie": { "libelle": "Véhicules", "code": "30" }, "code": "30" }, "dateFin": "2024-02-23T14:40:14.848Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "default": { "value": { "service": "/v1/mon_uri", "message": "Code inexistant: monCode", "code": 404 } } } } } } }, "security": [], "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } }, "/v1/competences/version": { "get": { "tags": [ "Versionning du ROME" ], "summary": "Récupérer la version actuelle du ROME", "description": "Récupère la version actuelle du ROME.", "operationId": "lireVersion", "parameters": [ { "name": "champs", "in": "query", "description": "Sélecteur de champs : il est possible de paramétrer le retour de la requête en définissant les champs souhaités (liste exhaustive des champs possibles : `Allowed values`).
Vous pouvez vous aider des exemples de réponse pour identifier les champs que vous voulez récupérer.", "required": false, "schema": { "type": "string", "enum": [ "version", "lastModifiedDate", "version,lastModifiedDate" ], "example": "version,lastModifiedDate" } }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer hITtO43KJEaw3-ODjpX7CzU3opQ" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VersionRome" }, "examples": { "Retour complet": { "value": { "version": "19", "lastModifiedDate": "2025-05-22T12:04:43.281Z" } }, "Retour par défaut": { "value": { "version": "19", "lastModifiedDate": "2025-05-22T12:04:43.281Z" } } } } } }, "400": { "description": "Bad request : peut-être causé par un sélecteur de champs incorrect", "content": { "application/json": { "examples": { "default": { "value": { "message": "L'attribut 'monAttribut' n'est pas selectionnable", "codeMetier": "SELECTOR", "service": "/v1/mon_uri", "code": 400 } } } } } } }, "servers": [ { "url": "https://api.francetravail.io/partenaire/rome-competences", "description": "PROD" } ] } } }, "components": { "schemas": { "CategorieSavoir": { "type": "object", "description": "Catégorie de Savoirs. Il y a seulement deux niveaux de catégories de savoirs: l'un qui dispose de sous-catégories et l'autre qui dispose d'une catégorie de savoir parente et de savoirs.", "properties": { "categorie": { "$ref": "#/components/schemas/CategorieSavoir" }, "code": { "type": "string", "description": "Code unique de la catégorie de savoirs.", "example": "30" }, "dateFin": { "type": "string", "description": "date de fin de validité (renseignée si l'entité est obsolete)", "format": "date-time" }, "libelle": { "type": "string", "description": "Libellé de la catégorie de savoirs.", "example": "Véhicules" }, "obsolete": { "type": "boolean", "description": "boolean définissant si l'entité est obsolete" }, "savoirs": { "type": "array", "description": "Savoirs.", "items": { "$ref": "#/components/schemas/Savoir" } }, "sousCategories": { "type": "array", "description": "Sous-catégories rattachées.", "items": { "$ref": "#/components/schemas/CategorieSavoir" } } } }, "Savoir": { "type": "object", "description": "Savoir.", "allOf": [ { "$ref": "#/components/schemas/Competence" }, { "type": "object", "properties": { "categorieSavoir": { "$ref": "#/components/schemas/CategorieSavoir" }, "type": { "type": "string", "description": "Cette propriété est forcément à la valeur 'SAVOIR'." } } } ] }, "Competence": { "type": "object", "description": "Compétence. Une compétence est forcément soit un macro-savoir-faire soit un macro-savoir-être professionnel, soit une compétence détaillée soit un savoir.", "properties": { "code": { "type": "string", "description": "Code unique de la compétence.", "example": "100253" }, "codeOgr": { "type": "string", "description": "Code OGR. Ce champ est conservé uniquement pour des raisons de rétro-compatibilité.", "example": "100253", "x-deprecated": true }, "competenceEsco": { "$ref": "#/components/schemas/CompetenceEsco" }, "dateFin": { "type": "string", "description": "date de fin de validité (renseignée si l'entité est obsolete)", "format": "date-time" }, "libelle": { "type": "string", "description": "Libellé de la compétence.", "example": "Anglais maritime" }, "obsolete": { "type": "boolean", "description": "boolean définissant si l'entité est obsolete" }, "transitionEcologique": { "type": "boolean", "description": "Transition écologique: oui/non. Ce champ est optionnel." }, "transitionNumerique": { "type": "boolean", "description": "Transition numérique: oui/non. Ce champ est optionnel." }, "type": { "type": "string", "description": "Le type de l'objet. Il y a quatre valeurs possibles :\n\n" } }, "discriminator": { "propertyName": "type" } }, "CompetenceEsco": { "type": "object", "description": "Compétence ESCO (en provenance du référentiel 'ESCO')", "properties": { "libelle": { "type": "string", "description": "Libellé de la compétence ESCO.", "example": "abattre des arbres" }, "uri": { "type": "string", "description": "Uri unique de la compétence ESCO.", "example": "http://data.europa.eu/esco/skill/b8cfe3d0-15a7-4be4-a7f1-f5141ed11f16" } } }, "CompetenceDetaillee": { "type": "object", "description": "Compétence détaillée.", "allOf": [ { "$ref": "#/components/schemas/Competence" }, { "type": "object", "properties": { "macroCompetence": { "$ref": "#/components/schemas/MacroCompetence" }, "riasecMajeur": { "type": "string", "enum": [ "R", "I", "A", "S", "E", "C" ], "description": "Riasec Majeur. Ce champ est optionnel." }, "riasecMineur": { "type": "string", "enum": [ "R", "I", "A", "S", "E", "C" ], "description": "Riasec Mineur. Ce champ est optionnel." }, "type": { "type": "string", "description": "Cette propriété est forcément à la valeur 'COMPETENCE-DETAILLEE'." } } } ] }, "MacroCompetence": { "type": "object", "description": "Macro-Compétence. Une macro-compétence est forcément soit un macro-savoir-faire soit un macro-savoir-être professionnel.", "allOf": [ { "$ref": "#/components/schemas/Competence" }, { "type": "object", "properties": { "codeArborescence": { "type": "string", "description": "Code Arborescence. Il s'agit d'un code unique sur cinq caractères qui est préfixé par le code arborescence de l'objectif lié." }, "competences": { "type": "array", "description": "Liste des compétences détaillées rattachées.", "items": { "$ref": "#/components/schemas/CompetenceDetaillee" } }, "definition": { "type": "string", "description": "Définition. Ce champ est optionnel." }, "maturite": { "type": "string", "enum": [ "HETEROGENE", "TRES_HOMOGENE", "HOMOGENE" ], "description": "Maturité de macro-compétence. Ce champ est optionnel." }, "objectif": { "$ref": "#/components/schemas/Objectif" }, "riasecMajeur": { "type": "string", "enum": [ "R", "I", "A", "S", "E", "C" ], "description": "Riasec Majeur. Ce champ est optionnel." }, "riasecMineur": { "type": "string", "enum": [ "R", "I", "A", "S", "E", "C" ], "description": "Riasec Mineur. Ce champ est optionnel." }, "sousCategorie": { "type": "string", "enum": [ "TECHNIQUE", "TECHNIQUE_EXPERT", "TRANSVERSE" ], "description": "Sous-catégorie de macro-compétence. Ce champ est optionnel." }, "transferable": { "type": "boolean", "description": "Transférable: oui/non. Ce champ est optionnel." }, "type": { "type": "string", "description": "Cette propriété est soit à la valeur 'MACRO-SAVOIR-ETRE-PROFESSIONNEL' soit à la valeur 'MACRO-SAVOIR-FAIRE'." } } } ], "discriminator": { "propertyName": "type" } }, "Objectif": { "type": "object", "description": "Objectif", "properties": { "code": { "type": "string", "description": "Code unique de l'objectif.", "example": "19" }, "codeArborescence": { "type": "string", "description": "Code Arborescence. Il s'agit d'un code unique sur trois caractères qui est préfixé par le code arborescence de l'enjeu lié.", "example": "10000.0" }, "dateFin": { "type": "string", "description": "date de fin de validité (renseignée si l'entité est obsolete)", "format": "date-time" }, "enjeu": { "$ref": "#/components/schemas/Enjeu" }, "libelle": { "type": "string", "description": "Libellé de l'objectif.", "example": "Soigner des animaux" }, "macroCompetences": { "type": "array", "description": "Liste des macros-compétences rattachées.", "items": { "$ref": "#/components/schemas/MacroCompetence" } }, "obsolete": { "type": "boolean", "description": "boolean définissant si l'entité est obsolete" } } }, "Enjeu": { "type": "object", "description": "Enjeu", "properties": { "code": { "type": "string", "description": "Code unique de l'enjeu.", "example": "7" }, "codeArborescence": { "type": "string", "description": "Code Arborescence. Il s'agit d'un code unique sur deux caractères dont le premier caractère de ce code correspond au code arborescence du domaine de compétence parent.", "example": "1E" }, "dateFin": { "type": "string", "description": "date de fin de validité (renseignée si l'entité est obsolete)", "format": "date-time" }, "domaineCompetence": { "$ref": "#/components/schemas/DomaineCompetence" }, "libelle": { "type": "string", "description": "Libellé de l'enjeu.", "example": "Soin" }, "objectifs": { "type": "array", "description": "Liste des objectifs rattachés.", "items": { "$ref": "#/components/schemas/Objectif" } }, "obsolete": { "type": "boolean", "description": "boolean définissant si l'entité est obsolete" } } }, "DomaineCompetence": { "type": "object", "description": "Domaine de compétence", "properties": { "code": { "type": "string", "description": "Code unique du domaine de compétence.", "example": "1" }, "codeArborescence": { "type": "string", "description": "Code Arborescence. Il s'agit d'un code unique sur un caractère qui est préfixe le code arborescence des enjeux liés au domaine.", "example": "1" }, "dateFin": { "type": "string", "description": "date de fin de validité (renseignée si l'entité est obsolete)", "format": "date-time" }, "enjeux": { "type": "array", "description": "Liste des enjeux rattachés.", "items": { "$ref": "#/components/schemas/Enjeu" } }, "libelle": { "type": "string", "description": "Libellé du domaine de compétence.", "example": "Management, Social, Soin" }, "obsolete": { "type": "boolean", "description": "boolean définissant si l'entité est obsolete" } } }, "MacroSavoirEtreProfessionnel": { "type": "object", "description": "Macro savoir-être professionnel.", "allOf": [ { "$ref": "#/components/schemas/MacroCompetence" }, { "type": "object", "properties": { "qualiteProfessionnelle": { "type": "string", "description": "Code sur deux caractères de la qualité professionnelle.\n\nUne qualité professionnelle décrit les capacités d’agir et d’interagir dans un contexte professionnel et sont contenues dans le référentiel 'Qualités professionnelles'.\n\nCe champ est optionnel.\n", "example": "01" }, "type": { "type": "string", "description": "Cette propriété est forcément à la valeur 'MACRO-SAVOIR-ETRE-PROFESSIONNEL'." } } } ] }, "MacroSavoirFaire": { "type": "object", "description": "Macro Savoir-Faire.", "allOf": [ { "$ref": "#/components/schemas/MacroCompetence" }, { "type": "object", "properties": { "type": { "type": "string", "description": "Cette propriété est forcément à la valeur 'MACRO-SAVOIR-FAIRE'." } } } ] }, "VersionRome": { "title": "VersionRome", "type": "object", "properties": { "version": { "type": "string", "description": "La version actuelle." }, "lastModifiedDate": { "type": "string", "description": "La date de dernière modification de la version.", "format": "date-time" } }, "description": "Version du rome" } } } }