Was Sie tun werden
- Einen Key mit begrenzten Scopes unter Settings → API keys erstellen - das Token wird nur einmal angezeigt, kopieren Sie es also sofort.
- Einen Link mit einem SDK-Aufruf oder einem einzigen
curl-Befehl in weniger als einer Minute kürzen. - Idempotency-Keys bei schreibenden Requests nutzen, damit Wiederholungen nie doppelte Links erzeugen.
Die Elido-API ist REST + JSON, nach OpenAPI 3.1 dokumentiert und pro Key ratenbegrenzt. Wir liefern eigene SDKs für TypeScript, Go und Python, die sie kapseln. Der MCP-Server in @elido/mcp-server stellt dieselbe Oberfläche für KI-Agenten bereit.
Einen API-Key erstellen
- Settings → API keys → Create key.
- Wählen Sie einen Namen (wir empfehlen das System, das ihn nutzen wird:
zapier,internal-billing,marketing-cli). - Wählen Sie Scopes. Die vier gängigen:
links:read- Links auflisten und ansehen.links:write- Links erstellen, aktualisieren, löschen.analytics:read- Klick-Events abfragen.webhooks:write- Webhook-Abonnements verwalten.
- Klicken Sie auf Create. Der Key wird einmalig angezeigt - wir speichern nur einen Hash.
Wenn Sie einen Key verlieren, widerrufen Sie ihn auf derselben Seite und erstellen Sie einen neuen. Widerrufene Keys werden in allen Regionen innerhalb von 60 Sekunden abgelehnt.
Schnellstart mit dem TypeScript-SDK
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);
Die Go- und Python-SDKs folgen demselben Aufbau. Die vollständige Referenz finden Sie unter /api.
Schnellstart mit 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"}'
Ratenlimits
Der Free-Tarif erhält 60 Requests pro Minute und Key. Pro: 600/min. Business: 6000/min. Der Burst beträgt das Doppelte des Dauerlimits; der Antwort-Header X-RateLimit-Remaining zeigt Ihnen, wo Sie stehen.
Erreichen Sie das Limit, antwortet die API mit 429 und gesetztem Retry-After. Die SDKs wiederholen standardmäßig mit exponentiellem Backoff - schalten Sie das ab, wenn Ihre App eine eigene Retry-Richtlinie hat.
Idempotenz
Schreibende Endpunkte akzeptieren einen Idempotency-Key-Header. Übergeben Sie pro beabsichtigtem Schreibvorgang eine UUID; wir cachen die Antwort 24 Stunden, sodass Wiederholungen (Netzwerkfehler, unklare Timeouts) keine Duplikate erzeugen.
Die SDKs fügen den Header automatisch hinzu. Wenn Sie curl direkt verwenden, erzeugen Sie den Key clientseitig und geben Sie ihn bei jeder Wiederholung mit.
Webhooks
Für Echtzeit-Benachrichtigungen statt Polling richten Sie Webhooks unter Settings → Webhooks ein - wir liefern Events wie link.created, link.updated und domain.verified mit HMAC-Signaturen. Events pro Klick sind noch nicht verfügbar; die vollständige Liste finden Sie im Webhooks-Leitfaden.