Connecteur Université d’Angers / HumanRoads

Nous avons mis en place une API permettant à Human Roads de récupérer automatiquement, grâce au login de l’utilisateur, les données liées au cursus universitaire et aux stages de l’étudiant issues du SI.

Conditions requises
Pour des raisons de sécurité, l’API ne peut être appelée que depuis l’IP du serveur Human Roads.
Pour appeler l’API, Human Roads a besoin de l’élément suivant :

- Login de l’étudiant

L’application Human Roads est reliée à notre système central d’authentification (CAS). L’étudiant se connecte avec son compte univ-angers.fr. Une fois connecté, le login de l‘étudiant est récupéré par Human Roads.

Réponse retournée
A chaque appel de l’API, il est retourné pour un étudiant :

- Le nom, prénom, email de l’étudiant
- L’année et le type de baccalauréat obtenu
- La formation suivie par l’étudiant au sein de l’Université d’Angers
- Les différents stages effectués dans le cadre de sa formation au sein de l’Université d’Angers

Nomenclature de l’API

Url de l’API : https://api.univ-angers.fr/api/humanroads/
Méthode d’appel : GET
Paramètres :

Paramètre	Description	Type
login *required	Login de l’étudiant utilisé au sein de l’Université d’Angers	string (path)

Réponse (application / JSON) :

Nom	Description	Type
nom	Nom de l’étudiant	string
prenom	Prénom de l’étudiant	string
email	Email de l’étudiant	string
code_bac	Type de baccalauréat obtenu	string
annee_bac	Année d’obtention du bac	string
diplomes	Liste des étapes de formation suivies par l’étudiant au sein de l’Université d’Angers	JSON objet
diplome > code_structure	Code de la structure	string
diplome > libelle_structure	Libelle de la structure	string
diplome > code_composante	Code de la composante	string
diplome > libelle_composante	Libellé de la composante	string
diplome > code_postal_composante	Code postal de la composante	string
diplome > ville_composante	Ville de la composante	string
diplome > code_diplome	Code du diplôme	string
diplome > code_version_diplome	Code de la version du diplôme	string
diplome > libelle_diplome	Libellé du diplôme	string
diplome > id_etape	Identifiant de l’étape	string
diplome > id_version_etape	Identifiant de la version de l’étape	string
diplome > libelle_version_etape	Libellé de la version de l’étape du diplôme	string
diplome > annee_entree	Année de début du diplôme	string
diplome > annee_obtention	Année d’obtention du diplôme. Si non obtenu ou en cours, valeur null	string
diplome > diplomante	Valeur ‘O’ si c’est une année diplômante, à ’N’ sinon.	string
stages	Liste des stages de l’étudiant	JSON object
stage > date_debut	Date de début du stage	string
stage > date_fin	Date de fin du stage	string
stage > libelle_stage	Libellé du stage	string
stage > nom_entreprise	Nom de l’entreprise où le stage a eu lieu	string
stage > cp_entreprise	Code Postal de l’entreprise où le stage a eu lieu	string
stage > ville_entreprise	Ville de l’entreprise où le stage a eu lieu	string
stage > pays_entreprise	Pays de l’entreprise où le stage a eu lieu	string

Exemple d’appel

https://api.univ-angers.fr/api/humanroads/adrid

Exemple de retour

{
       “nom”:“durand”,
       “prenom”:“adrien”,
       “email”:“adrid@etud.univ-angers.fr”,
       “code_bac”:“S”,
       “annee_bac”:“2016”,
       “diplomes”:
       [
             {
            “code_structure”:“S0000”,
             “libelle_structure”:“Faculté des sciences”,
             “code_composante”:“S00”,
             “libelle_composante”:“Faculté des Sciences”,
             “code_postal_composante”:“49045”,
             “ville_composante”:“ANGERS”,
             “code_diplome”:“TLSVT”,
             “code_version_diplome”:“730”,
             “libelle_diplome”:“Licence Sciences de la vie et de la terre”,
             “id_etape”:“TL3BCM”,
             “id_version_etape”:“1”,
             “libelle_version_etape”:“Licence 3 SVT”,
             “annee_entree”:“2017”,
               “annee_obtention”:“2018”,
               “diplomante”:“O”
             },…
       ],
       “stages”:
       [
             {
             “date_debut”:“07/01/2018”,
             “date_fin”:“01/03/2018”,
             “libelle_stage”:“Stage d’observation en recherche clinique”,
             “nom_entreprise”:“CHU Angers”,
             “cp_entreprise”:“49100”,
             “ville_entreprise”:“Angers”,
             “pays_entreprise”:“FR”
             }
       ]
}