Rechercher des formations et leurs avis

Présentation

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

Une formation est considérée comme similaire si elle possède au moins un FORMACODE ou un CERTIFINFOs identiquent à ceux de la formation dispensée.

 

Description de la requête

Point d'accès

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

 

Paramètres d'entrée

Code Cardinalité Format Description

id

0..n String Permet de filtrer la recherche avec un ou plusieurs identifiants de formations. L’identifiant d’une formation est de la forme suivante numero_formation
numero 0..1 String

Permet de filtrer la recherche avec un ou plusieurs numéros de formations

nb_avis

0..1 Integer Permet de filtrer la recherche en renvoyant uniquement les formations ayant un nombre d’avis égal ou supérieur à la valeur spécifiée

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

fields 0..1 String

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

Exemple: "score" renvoie uniquement le champ score "-avis" renvoie tous sauf le champ avis

page 0..1 Integer

Numéro de la page. Doit être supérieur ou égal à 0.

Par défaut : 0


items_par_page
 
0..1 Integer

Nombre de formations par page. Doit être inférieur ou égal à 2000.

Par défaut : 50

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/anotea/v1/formations?page=0&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/formations vers le domaine https://anotea.pole-emploi.fr/api/v1/formations.

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
formations 0..n Liste des Formations Liste des Formations
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 formations par page
meta.pagination.total_items 1 Integer Nombre de formations 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

{
  "formations": [
    {
      "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"
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 0,
      "items_par_page": 0,
      "total_items": 0,
      "total_pages": 0
    }
  }
}

 

Cas d'erreurs possibles

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