v002/membre/get-membres/

Description
Méthode GET (JsonP)
Méthode POST (application/x-www-form-urlencoded)

query : la représentation au format JSON de la requête

Paramètre query

{
   "projetId":1234,
   "apiKey":"xxxx",
   "responseFields":[
      "UTILISATEURS",
      "OBJETS_GERES",
      "PROJETS",
      "RELATIONS",
      "TRADUCTIONS",
      "TAGS",
      "COMMUNES"
   ],
   "filter":{
      "nom":"nom",
      "idParrain":12,
      "communeCodePostal":"69000",
      "communeCode":"69001",
      "types":[
         "type1",
         "type2"
      ],
      "idProjet":1234,
      "typeProjet":"type",
      "statutProjet":"DEVELOPPEMENT",
      "idSecteur":123,
      "nomSecteur":"secteur"
   }
}

projetId : identifiant du projet associé à la clé d’API

apiKey : clé d’API

responseFields (optionnel) : liste des champs supplémentaires de la réponse. Valeurs acceptées :
UTILISATEURS
OBJETS_GERES
PROJETS
RELATIONS
TRADUCTIONS
TAGS
COMMUNES

Cet appel liste uniquement les utilisateurs du membre (et non pas les utilisateurs enregistrés ou parrainés).

filter : paramétrés de recherche, au format JSON

• nom (optionnel) : nom du membre à récupérer
• idParrain (optionnel) : identifiant du membre parrain
• communeCodePostal (optionnel) : code postal de la commune au format chaîne (attention aux guillemets)
• communeCode (optionnel) : code INSEE de la commune au format chaîne (attention aux guillemets)
• types (optionnel) : types de membre (Contributeur Généraliste, Diffuseur Institutionnel, Prestataire Technique, etc.)
• idProjet (optionnel) : identifiant du projet du membre recherché
• typeProjet (optionnel) : type du projet (Site internet, Application ou site Mobile, Borne d’information, Intégration ponctuelle de données, Ecriture de métadonnées, Usages print et e-brochure, Synchronisation en écriture avec une plateforme tiers, Alimentation d’un autre système informatique, Autre type de projet, Panneaux d’information ou Apidae Connect (SSO))
• statutProjet (optionnel) : statut du projet (DEMONSTRATION, DEVELOPPEMENT, NON_DETERMINE ou PRODUCTION)
• idSecteur (optionnel) : identifiant du secteur
• nomSecteur (optionnel) : nom du secteur
• userStatus (optionnel) : ACTIFS (par défaut), INACTIFS ou TOUS

Exemple

/v002/membre/get-membres?query={"projetId":1234,"apiKey":"xxxx","responseFields":["UTILISATEURS","OBJETS_GERES","PROJETS","RELATIONS","TRADUCTIONS","TAGS","COMMUNES"],"filter":{"nom":"nom","idParrain":12,"communeCodePostal":"69000″,"communeCode":"69001″,"types":["type1″,"type2″],"idProjet":1234,"typeProjet":"type","statutProjet":"DEVELOPPEMENT","idSecteur":123,"nomSecteur":"secteur"}}

Cas d’erreur

Erreur 403 : Accès interdit
Erreur 50x : erreur de traitement ; le corps de la réponse HTTP contient le message d’erreur au format texte.

Permissions

Accès limité aux API de lecture : permet de voir exclusivement les champs « id », « nom », « niveauDiffusion », « devise », « type », « secteur », « urlLogo » et « descriptifCommercial »
Accès aux API de lecture : permet de voir toutes les informations du membre

Exemple de réponse

[
   {
      "id":1157,
      "nom":"Membre",
      "urlLogo":"http://api.apidae-tourisme.com/filestore/membres/logo-membres/1157.jpg",
      "niveauDiffusion":"STANDARD",
      "joursFeries": "FRANCE",
      "devise":"EUR",
      "type":{
         "id":233,
         "nom":"Contributeur Généraliste"
      },
      "secteur":{
         "id":1,
         "nom":"Hors secteurs",
         "description":"Secteur de test"
      },
      "notifications": {
         "notificationsApiExports": {
            "eMails": "info@apidae-tourisme.com"
         },
         "notificationsGestionObjets": {
            "eMails": "info@apidae-tourisme.com"
         }
      },
      "relations":{
         "parraines":[
            {
               "idMembre":1,
               "nomMembre":"nom"
            }
         ]
      },
      "permissions": [
         "CONTRIBUTEUR",
         "GESTIONNAIRE_PARRAINAGE_CONSULTATION",
         "GESTIONNAIRE_PARRAINAGE_SAISIE",
         "DIFFUSEUR_API_EXPORTS",
         "GESTIONNAIRE_CRITERE_INTERNE",
         "GESTIONNAIRE_IMPORTS",
         "GESTIONNAIRE_API_ECRITURE",
         "GESTIONNAIRE_INTEGRATION_MAPPING",
         "PRESTATAIRE_API_ECRITURE",
         "GESTIONNAIRE_TRADUCTION",
         "GESTIONNAIRE_ASPECTS",
         "GESTIONNAIRE_DONNEES_PRIVEES",
         "GESTIONNAIRE_TERRITOIRES",
         "PRESTATAIRE_TECHNIQUE",
         "TRADUCTEUR",
         "STATISTICIEN"
      ],
      "typesGeres": [
         {
            "nom": "ACTIVITE",
            "codeV1": "ACT",
            "codeTif": "02.01.01"
         },
         {
            "nom": "RESTAURATION",
            "codeV1": "RES",
            "codeTif": "02.01.13"
         }
      ],
      "tags":[
         {
            "idCategorie":1,
            "nomCategorie":"Test categorie",
            "tagsDetails":[
               {
                  "idTag":1,
                  "nomTag":"Test tag"
               }
            ]
         }
      ],
      "metadonnees": [
         {
            "nodeId": "nom-du-noeud"
         },
         {
            "nodeId": "nom-autre-noeud"
         }
      ],
      "entitesJuridiques":[
         {
            "id":123456,
            "nom":"Test",
            "identifier":"Test",
            "entitePrincipale":true
         }
      ],
      "utilisateurs":[
         {
            "id":1234,
            "nom":"Test",
            "prenom":"Test",
            "eMail":"test@laposte.net",
            "statut":"ACTIF",
            permissions: [
                "GESTIONNAIRE_OBJETS",
                "VALIDEUR_OBJETS",
                "GESTIONNAIRE_PARRAINAGE_CONSULTATION",
                "GESTIONNAIRE_PARRAINAGE_SAISIE",
                "GESTIONNAIRE_SAISIE_PRESTATAIRE",
                "PRESTATAIRE_TECHNIQUE",
                "CREATEUR_PROJET",
                "GESTIONNAIRE_PROJET",
                "AFFECTATION_CRITERES_INTERNES",
                "GESTIONNAIRE_IMPORT",
                "VALIDEUR_IMPORT",
                "VALIDEUR_API_ECRITURE",
                "PRESTATAIRE_API_ECRITURE",
                "GESTIONNAIRE_CONTRAT_TRADUCTION",
                "GESTIONNAIRE_TRADUCTION",
                "ADMINISTRATEUR_CHAMPS_PRIVES",
                "GESTIONNAIRE_DONNEES_PRIVEES",
                "TRADUCTEUR",
                "ADMIN_LOCAL",
                "ADMIN_DEPARTEMENTAL",
                "ADMIN_SECTEUR",
                "CREATEUR_TERRITOIRE",
                "ADMIN_FONCTIONNEL",
                "ADMIN_GLOBAL",
                "SIGN_IN_AS"
            ],
            "parraine":false
         }
      ],
      "communes":[
         {
            "id":12345,
            "nom":"Aagtekerke",
            "codePostal":"NL-4363 NB",
            "codeInsee":"ET066"
         }
      ],
      "projets":[
         {
            "id":1234,
            "nom":"Projet",
            "type":"DIFFUSION",
            "etat":"PRODUCTION",
            "statut":"PROPRIETAIRE",
            "dateDerniereGeneration":"2017-06-16T11:04:16.067+0000",
            "statutDernierExport":"ERROR",
            "technologies":[
               "API",
               "EXPORT"
            ]
         }
      ],
	  "traductions":[
	      {
		      "id": 123,
			  "nom": "Mon super contrat de traduction",
			  "langue": "nl",
			  "traducteur": {
			      "idMembre": 1234,
				  "nomMembre": "Mon Traducteur génial"
			  }
		  }
	  ],
      "objetsGeres":[
         {
            "id":123456,
            "nom":"Test",
            "identifier":"Test",
            "type":"STRUCTURE"
         }
      ],
      "informationsEdition": {
         "dateCreation": "2012-05-07T12:56:46.490+0000",
         "dateModification": "2019-09-30T09:47:17.008+0000",
         "utilisateurModification": {
            "idUtilisateur": 1234,
            "nomUtilisateur": "Nom Utilisateur",
            "prenomUtilisateur": "Prenom"
         }
      },
      "parrain": {
          "id": 1,
          "nom": "Auvergne - Rhône-Alpes Tourisme"
      }
   }
]