Endpoint
URL :/external-integration/activities
Méthode : GET
Authentification : Requiert un token LinkedAPI avec scope externalIntegration et une clé rattachée à un groupe d’agences.
Clé requise : toutes les clés (lecture seule suffit). Voir Types de clé.
Headers
Query Parameters
Pagination et tri
- Taille de page fixe : 20 activités.
- Itérez jusqu’à
hasMore: false. - Tri :
createdAtdécroissant (activité saisie le plus récemment en premier). - Le champ de taille de page de la réponse s’appelle ici
pageSize— maislimitsur GET Contacts, GET Users et GET Transaction Search. Même sens, deux noms : lisez celui de la route que vous appelez.
Exemples de requête
Réponse de succès
Code :200
Aucun résultat
Champs de la réponse
Chaque élément deactivities :
Aucun thumbnail n’est exposé. La pièce jointe
file.url est un lien S3 signé
temporaire vers un objet privé — à télécharger côté serveur, ne pas mettre en
cache durablement.Types d’activité
Le champtype est toujours en minuscules. Les types ci-dessous sont ceux que
vous rencontrerez le plus souvent en lecture ; la liste n’est pas fermée et de
nouveaux types peuvent apparaître.
Les visites et les offres sont des activités rattachées au match. Leur
lecture, le schéma de leur
data et leurs limites font l’objet d’une page
dédiée : Visites & offres.Écriture : ce qui n’est pas possible
POST /external-integration/activity est plus restreint que la lecture :
- types acceptés :
note,task,call,message,email,meeting,appointmentuniquement ; documentTypeaccepté :acquisition,sale,rental,contactuniquement.
Réponses d’erreur
documentmanquant :400 Bad Request
documentTypemanquant ou invalide :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
- Scope : seules les activités rattachées à un document de votre périmètre autorisé sont retournées.
- Pagination : 20 activités par page. Itérez jusqu’à
hasMore: false. - Pièces jointes :
file.urlest un lien S3 signé temporaire vers un fichier privé. Pas de thumbnail. Testezfileetfile.urlavant de télécharger : un document signé électroniquement, par exemple, peut remonter sans lien de téléchargement. - 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: