Passer au contenu principal
L’API d’intégration externe Avest permet à vos systèmes tiers de créer, mettre à jour et rechercher les ventes, acquisitions, locations, contacts et utilisateurs d’un groupe d’agences.

Pour commencer

1

Obtenir une clé API

Votre interlocuteur Avest vous fournit une clé API (token) rattachée à votre groupe d’agences. Voir Authentification.
2

Appeler l'API

Toutes les requêtes utilisent le header Authorization: Bearer {token}. Parcourez les Endpoints et la Référence API pour tester les requêtes directement depuis le navigateur.
3

Comprendre la déduplication

Les endpoints de création dédupliquent automatiquement contacts et transactions. Voir Déduplication & allocation.

URL de base

Toutes les requêtes ont pour base de production https://api.avest.fr/v1 (ex. https://api.avest.fr/v1/external-integration/contact).

Authentification

Toutes les requêtes sont authentifiées par un token LinkedAPI de scope externalIntegration, rattaché à un groupe d’agences. Chaque clé est en lecture seule ou en lecture-écriture : une écriture avec une clé en lecture seule reçoit un 403, identique à celui d’une requête sans token. Détails et tableau des codes d’erreur sur la page Authentification.