Rechercher des actions de formations

Présentation

Cette ressource permet d’obtenir la liste de toutes les actions de formations 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 actions de formation similaires.

Une action de 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/actions

Paramètres d'entrée

En-tête(s)	Valeur
Authorization	Bearer [Access token]

Code	Cardinalité	Format	Description
numero	0..1	String	Permet de limiter la recherche à un ou plusieurs identifiants d'actions de formation L’identifiant d’une session à la forme suivante : numero_formation\|numero_action Exemple : 14_AF_0000011111\|14_SE_0000102222
region	0..1	Integer	Permet de filtrer la recherche pour une région donnée
nb_avis	0..1	Integer	Permet de filtrer la recherche en renvoyant uniquement les actions 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	Integer 5	Permet de limiter les éléments renvoyés par la recherche sur les actions de formation. 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. Doit être supérieur ou égal à 0. Par défaut : 0
items_par_page	0..1	Integer	Nombre d'actions de formation 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/actions?numero=14_AF_0000011111|14_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/actions vers le domaine https://anotea.pole-emploi.fr/api/v1/actions.

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
actions	0..n	Liste des Actions	Liste des Actions
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 d'actions de formation par page
meta.pagination.total_items	1	Integer	Nombre d'actions de formation 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

{
"actions": [
    {
      "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"
            },
            "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"
          ],
          "lieu_de_formation": "string",
          "organisme_formateur": "string"
        },
        "source": {
          "numero_formation": "string",
          "numero_action": "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.