esup-multi

Arborescence des pages

Connecteur appelé par le module contacts. Il doit retourner une liste de contact pour une recherche donnée.

Paramètres d'appels

URL en méthode POST 

<host>/<uri>
  • host : adresse du serveur
  • uri : chemin éventuel vers le service

Body de la requête :

{
    type: String
    value: String
    userId: String
}

  • type : le type d’individu à chercher. On passera la valeur positionnée dans le fichier de config pour le label sélectionner par l’utilisateur. Au WS ensuite de se débrouiller avec la donnée envoyée.

  • value : la chaine recherchée.

  • userId (nullable) : le login de l’utilisateur connecté. Pourra être renseigné à null si l’utilisateur n’est pas authentifié sur l’application mobile.

Le login de l’utilisateur sera récupéré côté backend de multi, via le TGT fourni par le client.
Ce login sera ensuite transmis au connecteur qui se chargera de définir les droits de l’utilisateur concernant les résultats de la recherche possibles à retourner.

Format de retour

Format attendu

[
    {
        name: String
        firstname: String
        phoneNumbers: [String]
        mobileNumbers: [String]
        mailAddresses: [String]
        assignments: [String]
    }
]

  • name : nom de l’individu

  • firstname : prénom de l’individu

  • phoneNumbers : liste des numéros de téléphones de l’individu (par ordre de priorité)

  • mobilesNumbers : liste des numéros de mobiles de l’individu (par ordre de priorité)

  • mailAddresses : liste des adresses email de l’individu

  • assignments : liste des affectations de l’individu

    • pour un étudiant cela pourra être

      1. structure d’affectation

      2. cursus principal de l’année en cours

    • pour un personnel

      1. structure d’affectation

      2. service d’affectation

Cas d'erreur

  • Code HTTP 200 : en cas de résultats ou non (tableau vide)
  • Erreur HTTP 4xx ou 5xx : En cas de problème ou erreur

Exemple

Body de la requête
{
    type: "etudiant"
    value: "du"
    userId: "bissler5"
}


Réponse
[
    {
        "name": "Dupont",
        "firstname": "Patrick",
        "phoneNumbers": ["+33 3 72 74 11 12", "+33 3 72 74 11 13"],
        "mobileNumbers": ["+33 6 85 74 89 77"],
        "mailAddresses": ["patrick.dupont@univ-lorraine.fr"],
        "assignments": ["DN SIED - Sous-direction Système d'Information Etudes et Développement"]
    },
    {
        "name": "Dutilleuil",
        "firstname": "Émilie",
        "phoneNumbers": [],
        "mobileNumbers": [],
        "mailAddresses": ["emilie.dutilleuil2@etu.univ-lorraine.fr"],
        "assignments": ["IAE Nancy - Institut d'Administration des Entreprises - Ecole Universitaire de Management", "M2-Management et administration des entreprises PT Administration des entreprises (IAE NANCY) (FI)"]
    }
]


  • Aucune étiquette