Rechercher des sessions et leurs avis

Présentation

Cette ressource permet d’obtenir la liste de toutes les sessions contenues dans l’intercarif avec pour chacune d’elles, les avis réconciliés et le score. La réconciliation permet de rattacher des avis déposés sur des formations similaires.

Une formation est considérée comme similaire si elle possède un organisme formateur (SIRET), un lieu de formation (code postal) et au moins un FORMACODE ou CERTIFINFOs identiques à ceux de la formation dispensée durant la session.

 

Description de la requête

Point d'accès

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

 

Paramètres d'entrée

Code Cardinalité Format Description
numero 0..1 String

Permet de limiter la recherche à un ou plusieurs identifiants de sessions

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

Exemple : 14_AF_0000011111|14_SE_0000102222|SE_0000102222

region

0..1 Integer Permet de limiter la recherche en filtrant le session en fonction de leur région

nb_avis

0..1 Integer Permet de limiter la recherche renvoyant uniquement les sessions ayant un nombre d'avis égal ou supérieur à la valeur spécifiée
fields 0..1 Integer 5

Permet de limiter les éléments renvoyés par la recherche sur les sessions.

Exemple : "-avis" permet de ne pas récupérer les avis en retour de la recherche

page 0..1 Integer

Numéro de la page

Par défaut : 0


items_par_page
 
0..1 Integer

Nombre de sessions par page

Par défaut : 50

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/anotea/v1/sessions?numero=14_AF_0000011111|14_SE_0000102222|SE_0000102222&fields=-avis

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 vers le domaine https://anotea.pole-emploi.fr/api/v1/sessions.

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
sessions 0..n Liste des Sessions Liste des Sessions
meta 1 Sous-balise Informations complémentaires
meta.pagination 0..1 Sous-balise Informations sur la pagination
meta.pagination.page 1 Integer Numéro de la page
meta.pagination.items_par_page 1 Integer Nombre de sessions par page
meta.pagination.total_items 1 Integer Nombre de sessions au total
meta.pagination.total_pages 1 Integer Nombre de pages au total

 

Exemple de retour

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

{
  "sessions": [
    {
      "avis": {
        "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"
            },
            "session": {
              "numero": "string",
              "periode": {
                "debut": "string",
                "fin": "string"
              }
            }
          }
        }
      },
      "meta": {
        "reconciliation": {
          "certifinfos": [
            "string"
          ],
          "formacodes": [
            "string"
          ],
          "lieu_de_formation": "string",
          "organisme_formateur": "string"
        }
      },
      "score": {
        "nbAvis": 0,
        "notes": {
          "accueil": 0,
          "contenu_formation": 0,
          "equipe_formateurs": 0,
          "moyen_materiel": 0,
          "accompagnement": 0,
          "global": 0
        }
      }
    }
  ],
  "meta": {
    "pagination": {
            "page": 0,
            "per_page": 50,
            "total_items": 0,
            "total_pages": 0
    }
  }
}

 

Cas d'erreurs possibles

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