owner (présent sur les ventes, acquisitions, locations et contacts) en nom, prénom et photo.
Endpoint
URL :/external-integration/user
Méthode : GET
Authentification : Requiert un token LinkedAPI avec agencyGroup configuré.
Clé requise : toutes les clés (lecture seule suffit). Voir Types de clé.
Headers
Query Parameters
Un collaborateur désactivé, encore rattaché à une agence du groupe, est
renvoyé comme les autres : la réponse ne dit pas s’il est actif.
Exemples de requête
Réponse de succès
Code :200
Utilisateur trouvé
Utilisateur non trouvé
Champs retournés
Les champs optionnels sont omis lorsqu’ils ne sont pas renseignés.
Réponses d’erreur
idmanquant :400 Bad Request
idinvalide :400 Bad Request
- Paramètre de query inconnu :
400 Bad Request
- LinkedAPI agencyGroup manquant :
400 Bad Request
- Header
Authorizationabsent, ou IP non whitelistée sur une clé sécurisée :403 Not authorized to access this resource
- Token invalide :
401 Invalid bearer token
Différences avec /external-integration/users
Notes
- Scope : un utilisateur hors de votre périmètre autorisé ne sera jamais retourné (
user: null). - Croisement : l’
idcorrespond à l’identifiantownerdes ventes, acquisitions, locations et contacts. - Endpoint en lecture seule.
Rate limits
Cette route est limitée à 200 req / minute par groupe d’agences (bucket dédié, indépendant des autres routes).- Headers :
RateLimit-Limit,RateLimit-Remaining,RateLimit-Reset(secondes avant reset). - Dépassement →
429 Too Many Requestsavec headerRetry-After: