v002/membre/get-membres/

Recherche d’un membre.

/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",
       "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
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","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

Voir documentation-technique/v2/api-de-diffusion/liste-des-services/v002membreget-by-id-2/#exemple