Wat je gaat doen
- Geef een API-sleutel met scope uit via Instellingen → API-sleutels — de token wordt maar één keer getoond, dus kopieer hem meteen.
- Verkort een link met één SDK-aanroep of een enkel
curl-commando in minder dan een minuut. - Gebruik idempotency-keys op muterende requests zodat retries nooit links dubbel aanmaken.
De Elido API is REST + JSON, gedocumenteerd volgens OpenAPI 3.1, en rate-limited per sleutel. We leveren first-party SDK's voor TypeScript, Go en Python die de API omwikkelen. De MCP-server in @elido/mcp-server stelt hetzelfde oppervlak beschikbaar aan AI-agents.
Een API-sleutel uitgeven
- Instellingen → API-sleutels → Sleutel aanmaken.
- Kies een naam (we raden aan het systeem te gebruiken dat de sleutel gaat gebruiken:
zapier,internal-billing,marketing-cli). - Kies scopes. De vier meest voorkomende:
links:read— links weergeven en bekijken.links:write— links aanmaken, bijwerken, verwijderen.analytics:read— klikgebeurtenissen opvragen.webhooks:write— webhook-abonnementen beheren.
- Klik op Aanmaken. De sleutel wordt eenmalig getoond — we bewaren alleen een hash.
Als je een sleutel kwijtraakt, trek hem in vanaf dezelfde pagina en geef een nieuwe uit. Ingetrokken sleutels worden binnen 60 seconden in alle regio's geweigerd.
Snelstart met de 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);
De Go- en Python-SDK's volgen dezelfde opbouw. Volledige referentie op /api.
Snelstart met 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"}'
Rate limits
De gratis laag krijgt 60 requests per minuut per sleutel. Pro: 600/min. Business: 6000/min. Burst is 2× de steady-state-limiet; de responseheader X-RateLimit-Remaining laat zien waar je staat.
Als je de limiet overschrijdt, geeft de API 429 terug met Retry-After ingesteld. De SDK's implementeren standaard exponential-backoff retries — zet dit uit als je app zijn eigen retry-beleid afhandelt.
Idempotency
Muterende endpoints accepteren een Idempotency-Key-header. Geef een UUID mee per beoogde schrijfactie; we cachen de response 24 uur zodat retries (netwerkfouten, dubbelzinnige timeouts) niet dubbel aanmaken.
De SDK's voegen de header automatisch toe. Als je curl rechtstreeks gebruikt, genereer de sleutel dan client-side en neem hem op bij elke retry.
Webhooks
Voor realtime meldingen in plaats van polling, stel webhooks in onder Instellingen → Webhooks — we leveren link.created, link.clicked.aggregated en domain.verified events met HMAC-handtekeningen.