Récupérer le détail d'une session

Présentation

Cette ressource permet d’obtenir une session à partir de son identifiant.

Le score est calculé en prenant en compte l’intégralité des avis recueillis pour la session.

 

Description de la requête

Point d'accès

GET https://api.emploi-store.fr/partenaire/anotea/v1/sessions/{id}

 

Paramètres d'entrée

Code Cardinalité Format Description
id 1 String

L’identifiant d’une session à la forme suivante : numero_formation|numero_action|numero_session

Exemple : 14_AF_0000011111|14_SE_0000102222|SE_0000102222
notes_decimales 0..1 Booléen

Permet d'obtenir les notes en valeur décimale (arrondie à la dizaine).

Valeurs possibles :

  • true → notes en valeur décimale
  • false → notes en valeur entière

Par défaut : false

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/anotea/v1/sessions/14_AF_0000011111|14_SE_0000102222|SE_0000102222

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/sessions/{id} vers le domaine https://anotea.pole-emploi.fr/api/v1/sessions/{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 session
numero 1 String Numéro de la session
region 0..1 String

Région de la session

Liste des régions - Documentation INSEE
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 session
meta.reconciliation.formacodes 0..n String Liste des formacodes de la session
meta.reconciliation.lieu_de_formation 0..1 String Code postal du lieu de la session
meta.reconciliation.organisme_formateur 0..1 String SIRET de l'organisme formateur de la session
score 1 Sous-balise Score de la session
score.nb_avis 1 Integer Nombre d'avis de la session
score.notes 0..1 Sous-balise Notes de la session
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",
    "region": "string",
    "meta": {
        "reconciliation": {
            "organisme_formateur": "string",
            "lieu_de_formation": "string",
            "certifinfos": [
                "string"
            ],
            "formacodes": [
                "string",
                "string"
            ]
        },
        "source": {
            "type": "string",
            "region": "string",
            "numero_formation": "string",
            "numero_action": "string",
            "numero_session": "string"
        }
    },
    "score": {
        "nb_avis": 0
    }
}

 

Cas d'erreurs possibles

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

Syntaxe de la requête erronnée :

HTTP 400 Bad request
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache

{
    "statusCode": 400,
    "error": "Bad Request",
    "message": "Numéro de session invalide ou session expirée"
}