Récupérer le détail d'une formation
Présentation
Cette ressource permet d’obtenir une formation à partir de son identifiant
Description de la requête
Point d'accès
GET https://api.emploi-store.fr/partenaire/anotea/v1/formations/{id}
Paramètres d'entrée
En-tête(s) | Valeur |
---|---|
Authorization |
Bearer [Access token] |
Code | Cardinalité | Format | Description |
---|---|---|---|
id | 1 | String |
L’identifiant d’une formation à la forme suivante : numero_formation Exemple : 14_AF_0000011111 |
notes_decimales | 0..1 | Booléen |
Permet d'obtenir les notes en valeur décimale (arrondie à la dizaine). Valeurs possibles :
Par défaut : |
Exemple d'appel
GET https://api.emploi-store.fr/partenaire/anotea/v1/formations/14_AF_0000011111
Authorization: Bearer [Access token]
Description de la réponse
Lors de la réponse de l'API, une redirection (code HTTP 302 Found) est réalisée du domaine https://api.emploi-store.fr/api/anotea/v1/formations/{id}
vers le domaine https://anotea.pole-emploi.fr/api/v1/formations/{id}
.
Vous devez explicitement indiquer à votre client HTTP de suivre les redirections car il ne le fait probablement pas par défaut. Par exemple pour le client curl, il est nécéssaire d'utiliser curl --location
(ou curl -L
).
Données retournées
Code | Cardinalité | Format | Description |
---|---|---|---|
id | 1 | String | Identifiant de la formation |
numero | 1 | String | Numéro de la formation |
avis | 0..n | Tableau des Avis | Tableau des Avis |
meta | 1 | Sous-balise | Informations complémentaires |
meta.reconciliation | 0..1 | Sous-balise | Informations concernant la réconciliaion |
meta.reconciliation.certifinfos | 0..n | String | Liste des certifinfos de la formation |
meta.reconciliation.formacodes | 0..n | String | Liste des formacodes de la formation |
meta.reconciliation.organisme_formateur | 0..1 | String | SIRET de l'organisme formateur de la formation |
score | 1 | Sous-balise | Score de la formation |
score.nb_avis | 1 | Integer | Nombre d'avis de la formation |
score.notes | 0..1 | Sous-balise | Notes de la formation |
score.notes.accueil | 0..1 | Integer 1 | Moyenne des notes sur l'accueil (sur 5) |
score.notes.contenu_formation | 0..1 | Integer 1 | Moyenne des notes sur le contenu (sur 5) |
score.notes.equipe_formateurs | 0..1 | Integer 1 | Moyenne des notes sur l'équipe de formateurs (sur 5) |
score.notes.moyen_materiel | 0..1 | Integer 1 | Moyenne des notes sur les moyens matériels (sur 5) |
score.notes.accompagnement | 0..1 | Integer 1 | Moyenne des notes sur l'accompagnement (sur 5) |
score.notes.global | 0..1 | Integer 1 | Moyenne des notes globales (sur 5) |
Exemple de retour
HTTP 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
"id": "string",
"numero": "string",
"avis": {
"id": "string",
"pseudo": "string",
"date": "string",
"commentaire": {
"titre": "string",
"texte": "string"
},
"notes": {
"accueil": 0,
"contenu_formation": 0,
"equipe_formateurs": 0,
"moyen_materiel": 0,
"accompagnement": 0,
"global": 0
},
"formation": {
"intitule": "string",
"domaine_formation": {
"formacodes": [
"string"
]
},
"certifications": [
{
"certif_info": "string"
}
],
"action": {
"lieu_de_formation": {
"code_postal": "string",
"ville": "string"
},
"organisme_financeurs": [
"string"
],
"organisme_formateur": {
"raison_sociale": "string",
"siret": "string",
"numero": "string"
},
"session": {
"numero": "string",
"periode": {
"debut": "string",
"fin": "string"
}
}
}
}
},
"score": {
"nb_avis": 0,
"notes": {
"accueil": 0,
"contenu_formation": 0,
"equipe_formateurs": 0,
"moyen_materiel": 0,
"accompagnement": 0,
"global": 0
}
},
"meta": {
"reconciliation": {
"certifinfos": [
"string"
],
"formacodes": [
"string"
],
"organisme_formateurs": [
"string"
]
},
"source": {
"numero_formation": "string",
"type": "string"
}
}
}
Cas d'erreurs possibles
Retrouvez la liste des cas d'erreurs possibles sur la page Erreurs Types.