Clés API et démarrage rapide du SDK

Ce que vous allez faire

Générer une clé à portées limitées depuis Settings → API keys - le jeton n'est affiché qu'une seule fois, copiez-le donc immédiatement.
Raccourcir un lien avec un appel SDK ou une seule commande curl en moins d'une minute.
Utiliser des clés d'idempotence sur les requêtes qui modifient des données, pour que les nouvelles tentatives ne créent jamais de liens en double.

L'API Elido est en REST + JSON, documentée en OpenAPI 3.1 et limitée en débit par clé. Nous fournissons des SDK officiels pour TypeScript, Go et Python qui l'encapsulent. Le serveur MCP de @elido/mcp-server expose la même surface aux agents IA.

Générer une clé API

Settings → API keys → Create key.
Choisissez un nom (nous recommandons le système qui l'utilisera : zapier, internal-billing, marketing-cli).
Choisissez les portées. Les quatre courantes :
- links:read - lister et consulter les liens.
- links:write - créer, modifier, supprimer des liens.
- analytics:read - interroger les événements de clic.
- webhooks:write - gérer les abonnements aux webhooks.
Cliquez sur Create. La clé est affichée une seule fois - nous n'en conservons qu'un hash.

Si vous perdez une clé, révoquez-la depuis la même page et générez-en une nouvelle. Les clés révoquées sont rejetées en moins de 60 secondes dans toutes les régions.

Démarrage rapide avec le SDK TypeScript

import { ElidoClient } from "@elido/sdk";

const client = new ElidoClient({ apiKey: process.env.ELIDO_API_KEY! });

const link = await client.links.create({
  destination: "https://acme.com/spring-sale",
  slug: "spring-2026",
});

console.log(link.short_url);

Les SDK Go et Python suivent la même forme. Référence complète sur /api.

Démarrage rapide avec curl

curl -X POST https://api.elido.app/v1/links \
  -H "Authorization: Bearer $ELIDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination":"https://acme.com/spring-sale","slug":"spring-2026"}'

Limites de débit

Le forfait gratuit dispose de 60 requêtes par minute et par clé. Pro : 600/min. Business : 6000/min. Le débit de pointe est de 2× la limite en régime établi ; l'en-tête de réponse X-RateLimit-Remaining indique où vous en êtes.

Si vous atteignez la limite, l'API renvoie 429 avec Retry-After renseigné. Les SDK appliquent par défaut une nouvelle tentative avec backoff exponentiel - désactivez-la si votre application gère sa propre politique de nouvelles tentatives.

Idempotence

Les points de terminaison qui modifient des données acceptent un en-tête Idempotency-Key. Passez un UUID par écriture voulue ; nous mettons la réponse en cache 24 heures afin que les nouvelles tentatives (erreurs réseau, délais d'attente ambigus) ne créent pas de doublons.

Les SDK ajoutent l'en-tête automatiquement. Si vous utilisez curl directement, générez la clé côté client et incluez-la à chaque nouvelle tentative.

Webhooks

Pour des notifications en temps réel plutôt que de l'interrogation périodique, configurez des webhooks sous Settings → Webhooks - nous livrons des événements tels que link.created, link.updated et domain.verified avec des signatures HMAC. Les événements par clic ne sont pas encore disponibles ; consultez le guide des webhooks pour la liste complète.

Cela vous a-t-il été utile ?

Besoin de plus ? Écrivez à l'équipe - réponse sous un jour ouvré.Contacter le support