Guide de migration

Catégorie : Core
Domaine : SystemInfo
Service : UserReadAccessBasic
Méthode : GetUsersByEmail

Contrat de la V1

Verbe : GET
URL : https://cegid-expert-webapi-core.cegid.com/SystemInfo/UserReadAccessBasicWebService/GetUsersByEmail
Paramètres : QUERY
Le contrat de la V1 impose de renseigner une addresse électronique via le paramètre email.
Réponse :
Exemple avec l'utilisateur dont l'adresse électronique est johndoe@cegid.com:

{
    "users": [
        {
            "id": "JDO",
            "name": "DOE",
            "logOn": "JOHNDOE"
        }
    ]
}

Contrat de la V2

Verbe : POST
URL : https://api.cegid.com/cpa-expert-coreSystemInfo/UserConsultationWebService/UsersTracing
Paramètres : BODY
Le contrat de la V2 impose la pagination.
Pour obtenir la même donnée en V2, il est possible d’ajouter un filtre sur le bon numéro de propriété.

Les numéros des propriétés sont affichés dans l’APIM :

Filtrer sur la propriété 3 pour l'email avec l’opérateur de comparaison « Egal » (1) et la bonne valeur.

{
    "page": {
        "pageIndex": 1,
        "pageSize": 1
    },
    "filters": [{
        "property": 3,
        "constantValue": "johndoe@cegid.com",
        "comparisonOperateur": 1,
        "inversion": false,
        "logicOperator": 1
    }]
}

Réponse :
Le retour renvoie plus d’informations dans la V2.
Elles sont également organisées différemment.
Mais les informations disponibles dans la V1 le sont toujours dans la V2.

{
    "page": {
        "pageCount": 1
    },
    "users": [
        {
            "id": "JDO",
            "email": "johndoe@cegid.com",
            "group": "ADM",
            "identity": {
                "name": "DOE",
                "firstName": "John",
                "initials": "JD"
            },
            "connectionInfos": {
                "login": "JOHNDOE",
                "hashedPassword": "NWTvDKmMVr1piuWhSXHbPUpczZRCtrEOgnbmK72r3LM=",
                "connectionDate": "2026-02-11T10:27:05",
                "isConnected": true
            },
            "function": {
                "isController": true,
                "isAdministrator": true,
                "function": "Administrateur",
                "isInteractiveMode": true
            }
        }
    ]
}