Endpoint
URL :/external-integration/contacts
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 :
Paramètres supplémentaires :
Pagination
- Taille de page fixe : 100 contacts.
- Pas de
totalretourné. Itérez jusqu’àhasMore: false. pagemax : 100 (= 10 000 contacts cumulés).- Le champ de taille de page de la réponse s’appelle ici
limit— maispageSizesur GET Activities et GET Ad Search. Même sens, deux noms : lisez celui de la route que vous appelez.
Différences avec /external-integration/contact
Exemples de requête
Réponse de succès
Code :200
Aucun résultat
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
pagehors limites :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
Notes
- Mode
phone/email: matching exact. Tri parcreatedAtdesc. - Mode
search: tri par pertinence. - Scope : les contacts sont limités à votre périmètre autorisé.
- Pas de transactions : utiliser
/external-integration/contact(singulier) pour obtenir un contact + ses transactions associées. - Endpoint en lecture seule.
Rate limits
Cette route est limitée à 200 req / minute par groupe d’agences (bucket dédié).- Headers :
RateLimit-Limit,RateLimit-Remaining,RateLimit-Reset(secondes avant reset). - Dépassement →
429 Too Many Requestsavec headerRetry-After: