Passer au contenu principal
Recherche un contact par téléphone, email, ou texte libre, et retourne ses transactions associées (ventes, acquisitions, locations).

Endpoint

URL : /external-integration/contact 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

Exactement un des trois paramètres suivants doit être fourni :
Les trois paramètres sont mutuellement exclusifs. Zéro ou plus d’un → 400. Toute clé de query non listée → 400.

Exemples de requête

Réponse de succès

Code : 200

Contact trouvé

Contact non trouvé

Réponses d’erreur

  • Aucun paramètre fourni : 400 Bad Request
  • Plusieurs paramètres fournis : 400 Bad Request
  • Paramètre de query inconnu : 400 Bad Request
  • Téléphone invalide : 400 Bad Request
  • Email invalide : 400 Bad Request
  • search < 3 caractères : 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

Notes

  1. Mode phone / email : match exact. Retourne null si aucun contact ne correspond.
  2. Mode search : retourne le meilleur résultat selon la pertinence. Si plusieurs contacts matchent, seul le plus pertinent est retourné — utiliser phone ou email pour un match déterministe.
  3. Scope : les résultats sont limités à votre périmètre autorisé. Un contact hors périmètre ne sera jamais retourné.
  4. Transactions : seules les transactions où le contact est rattaché sont retournées. Les fiches de sales, acquisitions et rentals sont un résumé dont la forme peut évoluer : lisez-y id, customId, step et project, et récupérez le détail au format public avec GET Sale, GET Acquisition ou GET Rental.
  5. Endpoint en lecture seule.

Rate limits

Cette route est limitée à 500 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 :