API & SDKs. Build on Elido, in any language.

Oui. La version actuelle est la v1, accessible via /v1/... Les changements majeurs sont annoncés dans le journal des modifications avec une fenêtre d'obsolescence de 90 jours avant que l'ancien comportement ne soit supprimé. Les ajouts non disruptifs (nouveaux champs, nouveaux paramètres optionnels) sont publiés sans changement de version. La version de l'API est stable ; si la v2 est un jour introduite, la v1 fonctionnera en parallèle pendant au moins 12 mois. La spécification OpenAPI sur /openapi.json reflète toujours la version stable actuelle.

Authentification par jeton Bearer : incluez votre clé API dans l'en-tête Authorization sous la forme 'Bearer elido_sk_...'. La valeur de la clé n'est affichée qu'une seule fois à la création. Pour les appels de webhooks de serveur à serveur d'Elido vers votre système, Elido signe le corps de la requête avec HMAC-SHA256 en utilisant un secret partagé — vérifiez l'en-tête X-Elido-Signature sur votre gestionnaire de webhook. Les identifiants clients OAuth2 sont disponibles pour les intégrations partenaires où la distribution de clés API d'espace de travail n'est pas pratique — contactez-nous pour l'intégration partenaire OAuth2.

Oui. Le SDK TypeScript utilise l'API fetch (disponible dans tous les runtimes edge modernes) et évite les API spécifiques à Node.js (pas de fs, pas de http, pas de Buffer). Il est testé sur Cloudflare Workers, Vercel Edge Functions et Deno Deploy. Si vous exécutez le SDK dans un environnement edge contraint, utilisez le chemin d'importation léger (@elido/sdk/edge) qui exclut les utilitaires CLI et les modules spécifiques à Node.js du bundle.

Pour Claude : ajoutez le serveur MCP à votre fichier claude_desktop_config.json avec votre clé API comme variable d'environnement — la documentation MCP d'Elido propose un bloc de configuration à copier-coller. Pour ChatGPT (appel de fonctions) : le serveur MCP expose un manifeste d'outils JSON Schema sur /.well-known/mcp.json que vous pouvez importer dans la configuration des actions de votre GPT. Pour Cursor : ajoutez le serveur MCP comme outil local dans les paramètres de Cursor avec npx @elido/mcp-server. Toutes les configurations nécessitent une clé API Elido valide avec les portées pertinentes.

Tous les points de terminaison de liste utilisent une pagination basée sur un curseur. La réponse inclut un champ next_cursor (null s'il n'y a plus de pages). Passez la valeur du curseur comme paramètre de requête cursor lors de la requête suivante. La taille de page par défaut est de 50 ; le maximum est de 200. La pagination par curseur est stable — l'ajout ou la suppression d'enregistrements entre les pages ne provoque pas de saut ou de répétition d'éléments, contrairement à la pagination par décalage. Les SDK incluent un assistant d'auto-pagination qui renvoie les éléments un par un, indépendamment des limites de page.

Oui. Les clés API sont limitées à l'espace de travail, mais vous pouvez détenir des clés pour plusieurs espaces de travail. Le préfixe du point de terminaison de l'API est /v1/workspaces/{workspace_id}/... — passez l'ID de l'espace de travail cible. Si vous construisez un outil de gestion multi-espace de travail (par exemple, un portail d'agence gérant les espaces de travail des clients), vous détiendrez une clé API par espace de travail. Les identifiants partenaires OAuth2 avec une portée multi-espace de travail sont disponibles pour les intégrations de plateforme — contactez le service commercial.

Forfait gratuit : 60 requêtes par minute et par espace de travail. La limite de débit est appliquée au niveau de la passerelle API avec un algorithme de seau à jetons (token bucket). Lorsque le seau est vide, l'API renvoie une erreur HTTP 429 avec un en-tête Retry-After indiquant quand le prochain jeton sera disponible. Les SDK respectent automatiquement Retry-After sur les réponses 429. Notez que les points de terminaison en vrac ont des limites distinctes — le point de terminaison de création de liens en vrac compte pour une seule requête, quel que soit le nombre de liens dans la charge utile.

Oui — passez l'en-tête X-Elido-Sandbox: true à n'importe quelle requête API pour l'exécuter dans l'environnement de bac à sable. Les requêtes de bac à sable créent de réels objets dans une partition d'espace de travail isolée (liens, campagnes, etc.), mais le trafic de redirection n'est pas servi depuis l'edge de production. Utilisez le bac à sable pour les tests d'intégration et les pipelines CI/CD. Les objets du bac à sable ne sont pas décomptés de vos quotas de liens ou de clics de votre forfait. Le bac à sable est réinitialisé toutes les 24 heures — ne dépendez pas des données du bac à sable pour une utilisation en production.