Skip to main content
L’API AgencyHandy vous permet d’automatiser la création de leads, la gestion des clients, les mises à jour de commandes et bien plus encore depuis n’importe quel système externe ou script. Chaque requête est authentifiée à l’aide d’une clé API que vous générez depuis les paramètres de votre espace de travail. Ce guide vous accompagne dans l’obtention de vos identifiants et la réalisation de votre premier appel API.
Vous devez être SuperAdmin ou Admin de votre espace de travail AgencyHandy pour générer une clé API.

​
URL de base

Toutes les requêtes API sont effectuées vers :
Remplacez {{URL}} par cette URL de base dans tous les exemples de requêtes tout au long de la documentation de l’API.

​
Étape 1 : générer une clé API

1

Ouvrir Workspace Configuration

Accédez aux paramètres de votre espace de travail à l’adresse :
Cela ouvre l’onglet API Key dans Workspace Configuration.
2

Générer et copier votre clé API

Cliquez sur Generate (ou Regenerate si une clé existe déjà). Copiez la clé API et stockez-la en lieu sûr — traitez-la comme un mot de passe. AgencyHandy ne l’affichera plus après que vous aurez quitté la page.
Régénérer votre clé API invalide immédiatement la clé précédente. Toute intégration existante utilisant l’ancienne clé cessera de fonctionner jusqu’à ce que vous la mettiez à jour avec la nouvelle clé.

​
Étape 2 : récupérer votre Company ID

La plupart des points de terminaison de l’API nécessitent un en-tête companyid qui identifie l’espace de travail ciblé par la requête. Utilisez le point de terminaison suivant pour récupérer votre Company ID.

​
Point de terminaison

​
En-têtes

​
Exemple de requête

cURL

​
Exemple de réponse

1

Localiser votre Company ID

Dans la réponse, repérez le champ _id à l’intérieur du tableau companies. Il s’agit de votre Company ID.
2

Stocker le Company ID

Enregistrez le Company ID pour l’utiliser dans toutes les requêtes API ultérieures. Vous le transmettrez via l’en-tête companyid :

​
Récapitulatif de l’authentification

Chaque requête API authentifiée nécessite au minimum :
Une fois votre clé API et votre Company ID en main, vous êtes prêt à utiliser le reste de l’API AgencyHandy. Poursuivez avec l’un des guides de points de terminaison ci-dessous.