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.
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

É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

É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

À 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
204sans 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?