API ve SDK'lar. Elido üzerine, istediğiniz dilde inşa edin.
Tam REST API, TypeScript, Go ve Python SDK'ları, ayrıca AI ajan iş akışları için bir MCP sunucusu. Hız sınırları plana göre ölçeklenir; API anahtarları ayrıntılı izin setleriyle çalışma alanına kapsamlanmıştır.
- TypeScript, Go ve Python SDK'ları - tümü açık kaynak
- Etkileşimli dokümanlarla OpenAPI 3.1 spesifikasyonu
- Claude ve AI ajan iş akışları için MCP sunucusu
- Plana bağlı hız sınırlarıyla kapsam başına API anahtarları
Resmi SDK'lar
Dört SDK. Bir API yüzeyi.
Her SDK aynı OpenAPI 3.1 spesifikasyonundan üretilir - API gönderildiğinde, SDK'lar aynı gün güncellenir. TypeScript türleri, Go arayüzleri ve Python dataclass'ları otomatik olarak senkronize kalır.
Tipli istek/yanıt nesneleri. Node.js, Cloudflare Workers, Vercel Edge ve Deno'da çalışır.
npm install @elido/sdkYüksek verimli hizmetler için bağlam yayılımı ve sıfır tahsisli hızlı yollarla deyimsel Go.
go get github.com/elidoapp/elido-goSenkron ve asenkron (asyncio) istemciler. Pydantic v2 modelleriyle tiplendirilmiş. PyPI'de mevcut.
pip install elido-sdkModel Context Protocol sunucusu - Elido bağlantı yönetimini Claude, ChatGPT, Cursor ve herhangi bir MCP uyumlu AI ajanına bağlar.
npx @elido/mcp-serverAPI referansı
OpenAPI 3.1. Etkileşimli. Her zaman güncel.
Şu adresteki OpenAPI spesifikasyonu /openapi.json her uç nokta, parametre ve yanıt şekli için tek gerçek kaynaktır. SDK türleri ondan üretilir - sapma yok, elle bakımı yapılan taslak yok.
- İndirilebilir spesifikasyon/openapi.json - makine tarafından okunabilir JSON
- Etkileşimli referansTarayıcıdan kimliği doğrulanmış çağrılar
- Postman koleksiyonuOpenAPI spesifikasyonundan otomatik olarak üretilir
- SDK üretimiHer sürümde spesifikasyondan oluşturulan türler
- 90 günlük kullanımdan kaldırmaDeğişiklik gerektiren değişiklikler önceden işaretlenir
- POST
/v1/linksBir kısa bağlantı oluştur - GET
/v1/links/{id}Bir bağlantıyı kimliğe göre getir - PATCH
/v1/links/{id}Bağlantı hedefini veya metadata'sını güncelle - DELETE
/v1/links/{id}Bir bağlantıyı arşivle veya sil - GET
/v1/linksBağlantıları listele (imleç sayfalandırmalı) - POST
/v1/bulk/links500 bağlantıya kadar toplu oluştur
X-RateLimit-Remaining
X-RateLimit-Reset
Hız sınırları
Planınızla ölçeklenen sınırlar.
Çalışma alanı başına API anahtarı başına token bucket hız sınırlaması. Ani yükseliş toleransları, 5 saniyeye kadar 10 katına sıçramanıza izin verir - böylece bir kampanya başlangıcındaki toplu bağlantı oluşturma işi hiçbir zaman duvara çarpmaz.
- Her yanıtta X-RateLimit-Limit / Remaining / Reset başlıkları
- 429'da üstel geri çekilmeyle SDK otomatik yeniden denemeleri
- Toplu uç noktaların ayrı, daha yüksek sınırları var
- Kapsam başına anahtarlar - salt okunur analitik anahtarları yazma kotanızı tüketmez
- Yüksek hacimli kurumsal iş yükleri için özel sınırlar - satış ekibiyle iletişime geçin
Neler yapabilirsiniz
- OpenAPI 3.1 spesifikasyonuyla REST API
- TypeScript, Go ve Python SDK'ları
- Claude, ChatGPT, Cursor için MCP sunucusu
- Kapsam başına izinlerle çalışma alanına kapsamlanmış API anahtarları
- Asenkron olay teslimi için webhook'lar
- gRPC dahili API (edge → core)
Elido API yığını geliştiricilere ne sunar
Bir OpenAPI spesifikasyonu ve bazı SDK'lar asgari şarttır. Aşağıdaki yetenekler, üretim entegrasyonları oluştururken önemli olan ayrıntıları kapsar.
OpenAPI 3.1 spesifikasyonu, Postman koleksiyonu ve etkileşimli referans - örneklerle belgelenen her uç nokta
Her Elido API uç noktası, /docs/api-reference adresinde ve /openapi.json adresinde indirilebilir bir JSON dosyası olarak OpenAPI 3.1 spesifikasyonunda belgelenmiştir. Spesifikasyon tek gerçek kaynaktır - SDK türleri ondan üretilir, böylece referans ile SDK arasında sapma olmaz. Etkileşimli API referansı, tarayıcıdan doğrudan çalışma alanınıza karşı kimliği doğrulanmış çağrılar yapmanızı sağlar (API anahtarınızı yapıştırın, çalışma alanını seçin, uç noktayı çağırın). Bir Postman koleksiyonu, OpenAPI spesifikasyonundan otomatik olarak oluşturulur ve her uç noktanın belgeleme sayfasından bağlantılıdır. API için değişiklik günlüğü, ana değişiklik günlüğüyle birlikte sürümlendirilir - kaldırılmadan önce değişiklik gerektiren güncellemeler, bir geçiş kılavuzuyla birlikte 90 günlük bir kullanımdan kaldırma bildirimi alır.
TypeScript, Go ve Python SDK'ları - OpenAPI spesifikasyonundan üretilir, her API sürümünde güncellenir
TypeScript SDK'sı (@elido/sdk), npm'de yayınlanır ve tipli istek ve yanıt nesneleriyle tam API yüzeyini kapsar. Hem Node.js hem de edge çalışma zamanlarını (Cloudflare Workers, Vercel Edge, Deno) destekler. Go SDK'sı (github.com/elidoapp/elido-go), yüksek verim kullanım durumları için bağlam yayılımı ve sıfır tahsisli hızlı yollarla deyimsel Go'dur. Python SDK'sı (PyPI'de mevcut elido-python), hem senkron hem asenkron (asyncio) istemcileri içerir. Ruby SDK'sı (RubyGems'te elido gem'i), senkron HTTP ve ActiveRecord uyumlu hata türleriyle deyimsel Ruby gönderir. Dört SDK'nın tümü, özel bir üretici kullanılarak aynı OpenAPI spesifikasyonundan üretilir - güncellemeler API sürümüyle aynı gün gönderilir. Diliniz kapsanmıyorsa, bir istemci oluşturmanın en hızlı yolu OpenAPI spesifikasyonudur.
Kapsam başına izinlere sahip çalışma alanı API anahtarları - salt okunur analitik ile bağlantı yönetimi ile yönetici için ayrı anahtarlar
API anahtarları çalışma alanına kapsamlanmıştır (kullanıcıya değil) ve anahtar oluşturma anında tanımlanan bir izin setini içerir. Kapsamlar: links:read, links:write, links:delete, analytics:read, campaigns:read, campaigns:write, webhooks:manage, domains:manage, workspace:admin. Salt okunur analitik entegrasyonları yalnızca analytics:read içeren bir anahtar kullanmalıdır. Bağlantı oluşturan CI/CD hatları links:write kullanmalıdır. Yönetici işlemleri workspace:admin gerektirir. Anahtarlar, diğer anahtarları iptal etmeden tek tek döndürülebilir - döndürme yeni bir anahtar değeri oluşturur, eski değer hemen geçersiz kılınır. Anahtarlar yalnızca oluşturulduğunda bir kez gösterilir; Elido anahtarın düz metnini değil, HMAC'ını saklar. SCIM ile provizyonlanan ekipler için, üretim entegrasyonları için kişisel API anahtarları yerine hizmet hesabı anahtarları önerilir.
Elido MCP sunucusu: bağlantı yönetimini Claude, ChatGPT, Cursor ve herhangi bir MCP uyumlu AI ajanına bağlayın
Elido MCP sunucusu (npm'de yayınlanan @elido/mcp-server), Model Context Protocol'ü uygular ve Elido bağlantı yönetimini AI ajanları tarafından çağrılabilen araçlar olarak sunar. Desteklenen araçlar: create_link, get_link, update_link, list_links, get_analytics, create_campaign, list_campaigns. MCP sunucusu bir çalışma alanı API anahtarıyla kimlik doğrular ve araç erişimini anahtarın izinlerine kapsamlar. Bunu Claude'un araç kullanım döngüsüne, ChatGPT Eklentilerine (fonksiyon çağırma), Cursor'un AI bağlamına veya herhangi bir MCP uyumlu çalışma zamanına bağlayın. Kullanım örneği: doğal dilde bir brief alan ('bu ürün lansmanı için, her kanal için bir tane olmak üzere, Q2-lansman kampanya şablonundan UTM'lerle beş bağlantı oluştur') ve brief'ten türetilen doğru parametrelerle create_link'i beş kez çağıran bir AI asistanı. MCP sunucusu kendi kendine barındırılabilir veya yerel geliştirme için bir npx ikili dosyası olarak çalışır.
Plana göre hız sınırları - Free 60/dk, Pro 300/dk, Business 1.000/dk - artı ani yükseliş toleransları
API hız sınırları, çalışma alanı başına API anahtarı başına uygulanır: Free 60 istek/dakika, Pro 300/dakika, Business 1.000/dakika. Ani yükseliş toleransları, sert sınırlama devreye girmeden önce sınırı 5 saniyeye kadar (hız sınırının 10 katı) aşmanızı sağlar. Hız sınırı başlıkları her yanıta dahildir: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (Unix zaman damgası). SDK'lar, 429 yanıtlarında üstel geri çekilmeyle otomatik yeniden deneme içerir - bunu kendiniz uygulamanız gerekmez. Toplu işlemler için (bağlantı oluşturma, analitik dışa aktarma), öğe başına API çağrıları yerine toplu uç noktaları (POST /bulk, planlanmış dışa aktarımlar) tercih edin - toplu uç noktaların ayrı, daha yüksek sınırları vardır. Kullanım durumunuz Business sınırlarının üzerinde sürekli verim gerektiriyorsa (örneğin, önbellek doldurma için Elido'nun API'sini çağıran kendi kendine barındırılan yüksek hacimli bir yönlendirici), özel bir sınır için satış ekibiyle iletişime geçin.
Elido API'si üzerine inşa eden geliştirici ekipleri
Adlar yer tutucudur - gerçek müşteri vaka çalışmaları yayınlandıkça buraya eklenecektir.
“TypeScript SDK türleri OpenAPI spesifikasyonundan üretiliyor - Elido yeni bir API sürümü çıkardığında, paket sürümünü güncelliyoruz ve TypeScript, entegrasyonumuzun kullanımdan kaldırılmış bir alan kullanıp kullanmadığını hemen bize bildiriyor. Sürpriz çalışma zamanı hatası yok.”
“İçerik ekibimizin bir sohbet arayüzünden kampanya bağlantıları oluşturup etiketlemesine izin vermek için Elido MCP sunucusunu Claude'a bağladık. Kurulum 20 dakika sürdü. İçerik ekibi artık bağlantı yönetimi görevleri için mühendisliğe %40 daha az destek bileti açıyor.”
“Bağlam yayılımına sahip Go SDK'sı, hizmet ağımıza doğrudan uyuyor. Sevkiyat takip sayfaları için sunucu tarafında, sevkiyat oluşturma anında kısa bağlantılar oluşturuyoruz - SDK yeniden denemeleri ve hız sınırı geri çekilmesini şeffaf bir şekilde ele alıyor.”
Elido API ve SDK'lar vs Bitly API vs Rebrandly API
Üçünün de REST API'si var. Farklar; SDK kalitesinde, hız sınırlarında, OpenAPI spesifikasyonu mevcudiyetinde ve MCP/AI ajan desteğindedir.
| Feature | Elido | Bitly API | Rebrandly API |
|---|---|---|---|
| OpenAPI / Swagger spesifikasyonu | OpenAPI 3.1 - indirilebilir, SDK'lar için tek gerçek kaynak | Swagger spesifikasyonu mevcut | OpenAPI spesifikasyonu mevcut |
| Resmi SDK'lar | TypeScript, Go, Python - spesifikasyondan üretilir | Resmi JavaScript ve Python SDK'ları | Yalnızca JavaScript SDK |
| Hız sınırı (Business) | Ani yükselişle dakikada 1.000 istek | Enterprise planı: sözleşmeye göre değişir | Dakikada 500 istek (Business) |
| AI ajanları için MCP sunucusu | Var - npm'de @elido/mcp-server | Yok | Yok |
| Kapsam başına API anahtarı izinleri | Var - 9 kapsam, anahtar başına atama | Yalnızca salt okunur vs okuma-yazma | Sınırlı kapsam kontrolü |
| Webhook teslimi | HMAC-SHA256 imzalı, otomatik yeniden deneme, SIEM modu | Yok | Yok |
| gRPC dahili API | Var - edge'den core'a, düşük gecikmeli dahili çağrılar | Yalnızca REST | Yalnızca REST |
API ve SDK soruları
API sürümlü mü? Değişiklik gerektiren değişiklikler nasıl çalışır?
Evet. Mevcut sürüm v1'dir, /v1/... adresinden erişilir. Değişiklik gerektiren değişiklikler, eski davranış kaldırılmadan önce 90 günlük bir kullanımdan kaldırma penceresiyle değişiklik günlüğünde duyurulur. Geriye dönük uyumlu eklemeler (yeni alanlar, yeni isteğe bağlı parametreler) sürüm artışı olmadan gönderilir. API sürümü kararlıdır; bir v2 tanıtılırsa, v1 en az 12 ay paralel olarak çalışacaktır. /openapi.json adresindeki OpenAPI spesifikasyonu her zaman mevcut kararlı sürümü yansıtır.
API hangi kimlik doğrulama yöntemini kullanır?
Bearer token kimlik doğrulaması: API anahtarınızı Authorization başlığına 'Bearer elido_sk_...' olarak dahil edin. Anahtar değeri oluşturulduğunda bir kez gösterilir. Elido'dan sisteminize sunucudan sunucuya webhook çağrıları için, Elido istek gövdesini paylaşılan bir sırla HMAC-SHA256 kullanarak imzalar - webhook işleyicinizde X-Elido-Signature başlığını doğrulayın. Çalışma alanı API anahtarı dağıtımının pratik olmadığı ortak entegrasyonlar için OAuth2 istemci kimlik bilgileri mevcuttur - OAuth2 ortak katılımı için bizimle iletişime geçin.
TypeScript SDK'sı Cloudflare Workers ve edge çalışma zamanlarında çalışır mı?
Evet. TypeScript SDK'sı, fetch API'sini kullanır (tüm modern edge çalışma zamanlarında mevcuttur) ve yalnızca Node.js API'lerinden kaçınır (fs, http veya Buffer yok). Cloudflare Workers, Vercel Edge Functions ve Deno Deploy üzerinde test edilmiştir. SDK'yı kısıtlı bir edge ortamında çalıştırıyorsanız, paketten CLI araçlarını ve yalnızca Node.js modüllerini hariç tutan hafif içe aktarma yolunu (@elido/sdk/edge) kullanın.
MCP sunucusunu Claude veya ChatGPT ile nasıl kullanırım?
Claude için: MCP sunucusunu, API anahtarınızı bir ortam değişkeni olarak claude_desktop_config.json dosyanıza ekleyin - Elido MCP dokümanlarında kopyala-yapıştır tek bloklu bir yapılandırma var. ChatGPT (fonksiyon çağırma) için: MCP sunucusu, GPT'nizin eylem yapılandırmasına içe aktarabileceğiniz /.well-known/mcp.json adresinde bir JSON Schema araç manifestosu sunar. Cursor için: MCP sunucusunu Cursor'un ayarlarında npx @elido/mcp-server ile yerel bir araç olarak ekleyin. Tüm yapılandırmalar, ilgili kapsamlara sahip geçerli bir Elido API anahtarı gerektirir.
Liste uç noktaları için sayfalandırma modeli nedir?
Tüm liste uç noktaları imleç tabanlı sayfalandırma kullanır. Yanıt, bir next_cursor alanı içerir (daha fazla sayfa yoksa null). İmleç değerini bir sonraki istekte cursor sorgu parametresi olarak geçirin. Varsayılan sayfa boyutu 50'dir; maksimum 200'dür. İmleç tabanlı sayfalandırma kararlıdır - sayfalar arasında kayıt eklemek veya silmek, offset tabanlı sayfalandırmadan farklı olarak öğelerin atlanmasına veya tekrarlanmasına neden olmaz. SDK'lar, sayfa sınırlarından bağımsız olarak öğeleri birer birer veren bir otomatik sayfalandırma yardımcısı içerir.
Tek bir istemciden birden çok çalışma alanını yönetmek için API'yi kullanabilir miyim?
Evet. API anahtarları çalışma alanına kapsamlanmıştır, ancak birden çok çalışma alanı için anahtarlarınız olabilir. API uç nokta öneki /v1/workspaces/{workspace_id}/...'dir - hedef çalışma alanının kimliğini geçirin. Çok çalışma alanlı bir yönetim aracı oluşturuyorsanız (örneğin, müşteri çalışma alanlarını yöneten bir ajans portalı), çalışma alanı başına bir API anahtarı tutarsınız. Platform entegrasyonları için çalışma alanları arası kapsamlı OAuth2 ortak kimlik bilgileri mevcuttur - satış ekibiyle iletişime geçin.
Ücretsiz plandaki hız sınırı nedir ve nasıl uygulanır?
Free plan: çalışma alanı başına dakikada 60 istek. Hız sınırı, token bucket algoritmasıyla API ağ geçidinde uygulanır. Kova boşaldığında, API bir sonraki token'ın ne zaman kullanılabilir olacağını belirten bir Retry-After başlığıyla HTTP 429 döndürür. SDK'lar, 429 yanıtlarında Retry-After'a otomatik olarak uyar. Toplu uç noktaların ayrı sınırları olduğunu unutmayın - bağlantı toplu oluşturma uç noktası, yükte kaç bağlantı olduğuna bakılmaksızın bir istek olarak sayılır.
Bir sandbox veya test ortamı var mı?
Evet - herhangi bir API isteğini sandbox ortamına karşı çalıştırmak için X-Elido-Sandbox: true başlığını geçirin. Sandbox istekleri, sandbox'lı bir çalışma alanı bölümünde gerçek nesneler oluşturur (bağlantılar, kampanyalar, vb.) ama yönlendirme trafiği üretim edge'inden sunulmaz. Entegrasyon testi ve CI/CD hatları için sandbox'ı kullanın. Sandbox nesneleri, planınızın bağlantı veya tıklama kotalarına karşı sayılmaz. Sandbox her 24 saatte bir sıfırlanır - üretim kullanımı için sandbox verisine güvenmeyin.
Okumaya devam edin
HMAC imzalı giden olay teslimi - eşzamanlı API'nin asenkron tamamlayıcısı.
En çok çağıracağınız API kaynağı - kısa bağlantıları programatik olarak oluşturun, güncelleyin ve sorgulayın.
Analitik API üzerinden tıklama olaylarını ve toplamları sorgulayın - analitik paneliyle aynı veri.
Geliştirici odaklı çözüm sayfası - REST, SDK'lar, webhook'lar ve geliştirici deneyimi genel bakışı.
Denemeye hazır mısınız?
Ücretsiz planla başlayın, özel bir alan adına ihtiyacınız olduğunda yükseltin.