> ## Documentation Index
> Fetch the complete documentation index at: https://developers.avest.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> L'API d'intégration externe Avest : créer et synchroniser vos transactions, contacts et utilisateurs.

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](https://developers.avest.fr/guides/authentification.md).

**2. Appeler l'API**

Toutes les requêtes utilisent le header `Authorization: Bearer {token}`.
Parcourez les [Endpoints](https://developers.avest.fr/endpoints/get-contact.md) 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](https://developers.avest.fr/guides/deduplication.md).

## 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](https://developers.avest.fr/guides/authentification.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.