Was Sie tun
- Erstellen Sie einen Scoped API-Schlüssel unter Settings → API keys — das Token wird nur einmal angezeigt, also kopieren Sie es sofort.
- Kürzen Sie einen Link mit einem einzigen SDK-Aufruf oder einem einzelnen
curl-Befehl in unter einer Minute. - Verwenden Sie Idempotenz-Schlüssel bei mutierenden Anfragen, damit Wiederholungsversuche keine Links doppelt anlegen.
Die Elido API ist REST + JSON, nach OpenAPI 3.1 dokumentiert und pro Schlüssel ratenbegrenzt. Wir liefern First-Party SDKs für TypeScript, Go und Python aus, die diese kapseln. Der MCP server in @elido/mcp-server stellt KI-Agenten die gleiche Schnittstelle zur Verfügung.
Einen API-Schlüssel erstellen#
- Einstellungen → API-Schlüssel → Schlüssel erstellen.
- Wählen Sie einen Namen (wir empfehlen das System, das ihn verwenden wird:
zapier,internal-billing,marketing-cli). - Wählen Sie Scopes aus. Die vier gängigsten sind:
links:read— Links auflisten und untersuchen.links:write— Links erstellen, aktualisieren, löschen.analytics:read— Klick-Events abfragen.webhooks:write— Webhook-Abonnements verwalten.
- Klicken Sie auf Erstellen. Der Schlüssel wird nur einmal angezeigt — wir speichern lediglich einen Hash.
Falls Sie einen Schlüssel verlieren, widerrufen Sie ihn auf derselben Seite und erstellen Sie einen neuen. Widerrufene Schlüssel werden innerhalb von 60 Sekunden in allen Regionen 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 Muster. 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"}'
Ratenbegrenzungen#
Der kostenlose Tarif erhält 60 Anfragen pro Minute und Schlüssel. Pro: 600/min. Business: 6000/min. Der Burst beträgt das Zweifache des Dauerlimits; der Response-Header X-RateLimit-Remaining zeigt Ihnen, wo Sie stehen.
Wenn Sie das Limit erreichen, gibt die API 429 mit gesetztem Retry-After zurück. Die SDKs implementieren standardmäßig Exponential-Backoff-Wiederholungsversuche — schalten Sie dies aus, wenn Ihre App eine eigene Retry-Policy verwaltet.
Idempotenz#
Mutierende Endpunkte akzeptieren einen Idempotency-Key Header. Übergeben Sie eine UUID pro beabsichtigtem Schreibvorgang; wir speichern die Antwort für 24 Stunden zwischen, damit Wiederholungsversuche (Netzwerkfehler, mehrdeutige Timeouts) keine Duplikate erstellen.
Die SDKs fügen den Header automatisch hinzu. Wenn Sie curl direkt verwenden, generieren Sie den Schlüssel clientseitig und geben Sie ihn bei jedem Wiederholungsversuch an.
Webhooks#
Für Echtzeit-Benachrichtigungen anstelle von Polling richten Sie Webhooks unter Einstellungen → Webhooks ein — wir liefern link.created, link.clicked.aggregated und domain.verified Events mit HMAC-Signaturen aus.