Passer au contenu principal
Récupère un utilisateur (collaborateur) par son identifiant. Pratique pour résoudre un 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

id est obligatoire et doit être un identifiant valide → sinon 400. Toute clé de query non listée → 400.
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.
Bonne pratique : n’appelez pas cette route en boucle pour résoudre chaque owner rencontré. Récupérez plutôt l’annuaire complet une seule fois via /external-integration/users, mettez-le en cache de votre côté, et faites la correspondance id → utilisateur localement. Réservez cette route aux cas ponctuels (un identifiant isolé, ou un rafraîchissement ciblé).

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

  • id manquant : 400 Bad Request
  • id invalide : 400 Bad Request
  • Paramètre de query inconnu : 400 Bad Request
  • LinkedAPI agencyGroup manquant : 400 Bad Request
  • Header Authorization absent, 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

  1. Scope : un utilisateur hors de votre périmètre autorisé ne sera jamais retourné (user: null).
  2. Croisement : l’id correspond à l’identifiant owner des ventes, acquisitions, locations et contacts.
  3. 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 Requests avec header Retry-After :