Neler yapacaksınız
- Ayarlar → API anahtarları üzerinden kapsamlı (scoped) bir API anahtarı oluşturun — jeton yalnızca bir kez gösterilir, bu yüzden hemen kopyalayın.
- Tek bir SDK çağrısı veya tek bir
curlkomutuyla bir dakikadan kısa sürede bir bağlantıyı kısaltın. - Yeniden denemelerin bağlantıları asla iki kez oluşturmaması için değiştiren (mutating) isteklerde idempotency anahtarları kullanın.
Elido API'si REST + JSON'dur, OpenAPI 3.1 ile belgelenmiştir ve anahtar başına hız sınırlıdır. TypeScript, Go ve Python için bunu saran birinci taraf SDK'lar sunuyoruz. @elido/mcp-server içindeki MCP sunucusu aynı yüzeyi AI ajanlarına da sunar.
API anahtarı oluşturma
- Ayarlar → API anahtarları → Anahtar oluştur.
- Bir isim seçin (bunu kullanacak sistemi önermenizi tavsiye ederiz:
zapier,internal-billing,marketing-cli). - Kapsamları seçin. Dört yaygın olanı:
links:read— bağlantıları listeleme ve inceleme.links:write— bağlantı oluşturma, güncelleme, silme.analytics:read— tıklama olaylarını sorgulama.webhooks:write— webhook aboneliklerini yönetme.
- Oluştur'a tıklayın. Anahtar bir kez gösterilir — biz yalnızca bir hash saklarız.
Bir anahtarı kaybederseniz, aynı sayfadan iptal edin ve yenisini oluşturun. İptal edilen anahtarlar tüm bölgelerde 60 saniye içinde reddedilir.
TypeScript SDK ile hızlı başlangıç
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);
Go ve Python SDK'ları aynı yapıyı izler. Tam referans için /api.
curl ile hızlı başlangıç
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"}'
Hız sınırları
Ücretsiz katman anahtar başına dakikada 60 istek alır. Pro: 600/dk. Business: 6000/dk. Burst, sabit-durum sınırının 2 katıdır; X-RateLimit-Remaining yanıt başlığı nerede durduğunuzu söyler.
Sınırı aşarsanız API, Retry-After ayarlanmış şekilde 429 döndürür. SDK'lar varsayılan olarak üstel geri çekilme (exponential-backoff) ile yeniden deneme uygular — uygulamanız kendi yeniden deneme politikasını yönetiyorsa bunu kapatın.
Idempotency
Değiştiren (mutating) uç noktalar bir Idempotency-Key başlığı kabul eder. Amaçlanan her yazma için bir UUID geçirin; yeniden denemelerin (ağ hataları, belirsiz zaman aşımları) çift oluşturma yapmaması için yanıtı 24 saat önbelleğe alırız.
SDK'lar başlığı otomatik olarak ekler. Doğrudan curl kullanıyorsanız, anahtarı istemci tarafında üretin ve her yeniden denemede dahil edin.
Webhook'lar
Yoklama (polling) yerine gerçek zamanlı bildirimler için Ayarlar → Webhook'lar altında webhook kurun — link.created, link.clicked.aggregated ve domain.verified olaylarını HMAC imzalarıyla teslim ederiz.