Comment fonctionne l'API Alori?

Créez une clé dans Connecteurs › API. Votre logiciel lit et modifie vos dossiers à api.alori.dev/v1, avec des réessais sécuritaires, la pagination et des erreurs claires.

Écrit par Philippe Genois

Mis à jour le 19 novembre 2026

L'API Alori permet à votre propre logiciel de lire et de modifier votre CRM : clients, opportunités, entreprises, soumissions, contrats, factures, tâches, concurrents dans votre rapport SEO et plus encore. Créez une clé sur la page API de données, puis envoyez des requêtes à https://api.alori.dev/v1 avec la clé.

Aussi appelé : REST API, developer API, API key, integration, endpoint, webhook, API REST, clé API, intégration, développeur

Étape 1 : Ouvrir la page API de données

Ouvrez Connecteurs dans le menu en grille en haut à droite et cliquez sur la carte API. La page API de données affiche votre URL de base, vos clés, vos webhooks et un guide avec les véritables champs de votre application.

Cliquez sur : Connecteurs › API

La page API de données avec l'URL de base et les clés

Étape 2 : Créer une clé

Cliquez sur Nouvelle clé, tapez un Nom de clé et choisissez son utilisation : Rapports (lecture seule) permet uniquement la lecture, Importation ajoute et met à jour des dossiers, et Accès complet permet également de supprimer, d'envoyer des textos et des courriels, de planifier des réunions et de recevoir des webhooks. Cliquez sur Créer la clé, puis sur Copier. Vous pourrez l'afficher de nouveau plus tard à partir de votre liste de clés.

Cliquez sur : Nouvelle clé › Accès complet › Créer la clé › Copier

La fenêtre Nouvelle clé avec l'option Accès complet sélectionnée

Étape 3 : Envoyer votre première requête

Envoyez la clé dans l'en-tête Authorization : Authorization: Bearer <votre clé>. Le guide Comment utiliser l'API sur la même page contient des exemples de code en cURL, JavaScript et Python, avec les champs de votre application.

Cliquez sur : Comment utiliser l'API

Le guide Comment utiliser l'API avec des exemples de code

À quoi ressemblent les réponses

  • Une seule chose est retournée sous la forme { "data": { … } }. Une liste est retournée sous la forme { "data": [ … ], "nextCursor": "…" }.

  • Chaque objet a son propre id.

  • Les dates et les heures sont au format texte ISO, comme "2026-11-18T14:03:00.000Z". Vous pouvez les envoyer sous forme de texte ISO ou en millisecondes.

  • Une suppression répond 204 sans corps de réponse.

Lire de longues listes

Ajoutez limit (jusqu'à 500) pour choisir la taille de la page. Lorsque nextCursor n'est pas nul, renvoyez-le sous la forme cursor pour obtenir la page suivante. La dernière page a nextCursor: null. Une page filtrée peut être courte, voire vide, et avoir quand même un nextCursor : continuez jusqu'à ce qu'il soit nul.

Réessais sécuritaires

Ajoutez un en-tête Idempotency-Key (n'importe quel texte unique, comme un UUID) à une requête qui crée, modifie ou supprime quelque chose. Si la connexion est interrompue et que vous renvoyez la même requête avec la même clé dans un délai de 24 heures, Alori répond avec le premier résultat au lieu de l'exécuter deux fois, de sorte qu'un client ne reçoive jamais le même texto deux fois.

Limites

Chaque clé peut effectuer 1 000 requêtes par minute, et jusqu'à 1 000 d'un coup après une pause. Une requête lit ou envoie jusqu'à 500 dossiers. L'en-tête RateLimit-Remaining indique le nombre de requêtes restantes.

Si cela ne fonctionne pas

Chaque erreur est retournée sous la forme { "error": { "code", "message", "requestId" } }. Envoyez-nous le requestId et nous pourrons retrouver cette requête exacte.

  • « Clé API manquante, révoquée ou inconnue. » Vérifiez l'en-tête Authorization, ou créez une nouvelle clé.

  • « Cette clé ne peut pas faire cela… » Le type de la clé ne le permet pas. Créez une clé avec Accès complet.

  • « Trop de requêtes. Attendez un moment et réessayez. » Attendez le nombre de secondes indiqué dans Retry-After, puis renvoyez la requête.

  • « Cet Idempotency-Key a déjà été utilisé pour une requête différente. » Utilisez une nouvelle clé pour chaque nouvelle requête.

Articles connexes

Cet article a-t-il répondu à votre question?

NonEn partieOui
Créé avec Alori