REST API
Bağlantılarınızın üzerine inşa edin.

Kimlik, çalışma alanı, plan ve o planın sağladığı tüm haklar. Bir tokenı doğrulamanın ve hesabın neye izinli olduğunu denemeden önce öğrenmenin en ucuz yolu.

curl -H "X-API-KEY: YOUR_TOKEN" \
  https://letl.ink/api/v1/me

{
  "data": {
    "user": { "id": 1, "email": "[email protected]", "name": "You" },
    "workspace": { "id": 12, "name": "My Workspace", "block_bots": true },
    "plan": {
      "id": "growth",
      "name": "Growth",
      "limits": {
        "links": 200,
        "monthly_clicks": 100000,
        "custom_domains": 3,
        "qr_codes": 30,
        "retention_days": 365
      },
      "features": {
        "api": true,
        "webhooks": true,
        "integrations": true,
        "ai_access": false,
        "geo_analytics": false,
        "smart_link_types": true
      }
    },
    "base_domain": "letl.ink"
  }
}

Bu fatura ayında her kotanın ne kadarının kullanıldığı. Bir müşteriyi izlenen tıklama sınırına ulaşmadan önce uyarmak için kullanın — sınır aşıldığında yönlendirme yine çalışır, ancak tıklamalar kaydedilmez.

{
  "data": {
    "links": { "used": 42, "limit": 200, "remaining": 158, "percent_used": 21.0 },
    "clicks_this_month": { "used": 8140, "limit": 100000, "remaining": 91860, "percent_used": 8.1 },
    "custom_domains": { "used": 1, "limit": 3, "remaining": 2, "percent_used": 33.3 },
    "qr_codes": { "used": 4, "limit": 30, "remaining": 26, "percent_used": 13.3 }
  },
  "meta": { "plan": "growth", "period": "2026-09" }
}

Çalışma alanındaki özel alan adları ve her birinin DNS doğrulamasını tamamlayıp tamamlamadığı. Bağlantı oluştururken domain alanında yalnızca doğrulanmış alan adları kullanılabilir.

Ürünün sunduğu her entegrasyon; planınızın onu içerip içermediği, bu çalışma alanının onu bağlayıp bağlamadığı ve teslimatın nasıl gittiği — son durum, son hata ve art arda başarısızlık sayısı. Çok sayıda çalışma alanını izlemek için kullanışlıdır.

Çalışma alanındaki bağlantılar; tıklama toplamları all, ios, android ve desktop olarak ayrılmış. Hiç tıklanmamış bağlantılar da dahildir.

Sorgu parametreleri

• domain string

  Tek bir ana bilgisayar adıyla sınırlayın. Çalışma alanındaki tüm ana bilgisayar adlarını listelemek için boş bırakın.

  İsteğe bağlı
• search string

  Kısa kod, başlık ve hedefle eşleşir.

  İsteğe bağlı
• type string

  direct, utm, appstore, instagram, mobile veya device.

  İsteğe bağlı
• archived boolean

  Varsayılan false. Bunun yerine arşivi listelemek için true gönderin.

  İsteğe bağlı
• favorite boolean

  Yıldızlı bağlantılarla sınırlayın.

  İsteğe bağlı
• sort string

  created_at (varsayılan), clicks, short_code, title veya updated_at.

  İsteğe bağlı
• direction string

  asc veya desc. Varsayılan desc.

  İsteğe bağlı
• limit integer

  1–200. Varsayılan 50.

  İsteğe bağlı
• offset integer

  Varsayılan 0.

  İsteğe bağlı
• start_date date

  YYYY-MM-DD. Hangi bağlantıların döndürüleceğini değil, tıklama toplamlarının aralığını belirler.

  İsteğe bağlı
• end_date date

  YYYY-MM-DD, dahil.

  İsteğe bağlı

curl -H "X-API-KEY: YOUR_TOKEN" \
  "https://letl.ink/api/v1/links?sort=clicks&limit=20"

{
  "data": [
    {
      "id": 49,
      "short_code": "spring",
      "domain": "letl.ink",
      "url": "https://letl.ink/spring",
      "destination": "https://shop.example.com/spring",
      "title": "Spring sale",
      "type": "utm",
      "archived": false,
      "favorite": true,
      "created_at": "2026-08-01T09:14:00+00:00",
      "updated_at": "2026-09-02T11:00:00+00:00",
      "clicks": { "all": 650, "ios": 180, "android": 210, "desktop": 260 },
      "total_clicks": 650,
      "device_limit": null,
      "utm": { "source": "twitter", "medium": "social", "campaign": "spring" },
      "split_test": {
        "variations": [
          { "name": "control", "url": "https://example.com/a", "weight": 2 },
          { "name": "variant-b", "url": "https://example.com/b", "weight": 1 }
        ]
      }
    }
  ],
  "meta": {
    "total": 42, "limit": 20, "offset": 0,
    "has_more": true, "next_offset": 20,
    "sort": "clicks", "direction": "desc",
    "date_range": { "start_date": null, "end_date": null },
    "domain": "all"
  }
}

Kimliğe göre tek bir bağlantı, liste uç noktasının döndürdüğü yapıyla aynı.

Kısa bağlantı oluşturun. Rastgele bir kod için short_code alanını boş bırakın. Hedefin title değeri yoksa sayfa başlığını arka planda getiririz.

JSON gövdesi

• destination

  Yönlendirilecek URL. direct ve utm bağlantıları için zorunludur. original_url takma ad olarak kabul edilir.

  Gerekli*
• short_code

  En fazla 20 karakter: harfler, rakamlar, kısa çizgiler ve alt çizgiler; ayırıcıyla başlayamaz veya bitemez. Her ana bilgisayar adı için benzersiz olmalıdır.

  İsteğe bağlı
• title

  Paneldeki görünen ad.

  İsteğe bağlı
• domain

  Doğrulanmış bir özel alan adı veya temel alan adı. Varsayılan temel alan adıdır.

  İsteğe bağlı
• type

  direct (varsayılan), utm, appstore, instagram, mobile veya device. direct ve utm dışındaki her şey Solo, Growth veya Ultimate planı gerektirir.

  İsteğe bağlı
• utm_source, utm_medium, utm_campaign

  utm bağlantıları için; type değeri utm olduğunda utm_source zorunludur.

  İsteğe bağlı
• ios_url, android_url

  appstore ve mobile bağlantıları için platform hedefleri.

  İsteğe bağlı
• desktop_url, mobile_url

  device bağlantıları için ikisi de zorunludur.

  İsteğe bağlı
• instagram_username

  instagram bağlantıları için.

  İsteğe bağlı
• split_variations

  direct veya utm bağlantısında ağırlıklı bir A/B testi çalıştırmak için {name, url, weight} nesnelerinden oluşan bir dizi — en az iki tane.

  İsteğe bağlı
• limit_visits_per_device

  Cihaz başına saatlik ziyaretleri sınırlamak için true olarak ayarlayın ve visit_limit_per_device değerini girin.

  İsteğe bağlı

curl -X POST https://letl.ink/api/v1/links \
  -H "X-API-KEY: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "destination": "https://shop.example.com/spring",
        "short_code": "spring",
        "title": "Spring sale",
        "type": "utm",
        "utm_source": "twitter",
        "utm_campaign": "spring"
      }'

The created link, in the shape shown above.

Tek bir istekte çok sayıda bağlantı oluşturun. Her satır bağımsız olarak denenir: geçerli satırlar oluşturulur ve hatalar dizin bazında raporlanır; böylece tek bir hatalı URL grubun geri kalanını asla iptal etmez. Herhangi bir şey oluşturulduysa 201, hiçbir şey oluşturulmadıysa 422 döndürür.

curl -X POST https://letl.ink/api/v1/links/bulk \
  -H "X-API-KEY: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"links":[
        {"destination":"https://example.com/1","short_code":"one"},
        {"destination":"https://example.com/2"}
      ]}'

{
  "data": [ { "id": 51, "short_code": "one", … } ],
  "meta": {
    "requested": 2,
    "created": 1,
    "failed": 1,
    "errors": [
      { "index": 1,
        "code": "invalid_request",
        "message": "This shortcode is already taken.",
        "short_code": "two" }
    ]
  }
}

PATCH birleştirir: yalnızca gönderdiğiniz alanlar değişir, geri kalan her şey mevcut değerini korur. PUT değiştirir: atladığınız her şey temizlenir. Oluşturma ile aynı alanları kabul eder.

curl -X PATCH https://letl.ink/api/v1/links/49 \
  -H "X-API-KEY: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Spring sale — extended"}'

Bağlantıyı arşivler: bağlantı çalışmayı durdurur ve bir kota yeri açılır, tıklama geçmişi ise korunur. API'de bilerek kalıcı silme yoktur — bir bağlantıyı ve geçmişini yok etmek, açık onay gerektiren bir panel işlemi olarak kalır.

Arşivlenmiş bir bağlantıyı yeniden kullanıma alır. Çalışma alanı etkin bağlantı kotasına zaten ulaşmışsa 403 plan_required döndürür.

Tek bir bağlantıya yapılan ziyaretler, en yeniden eskiye. limit ve offset kabul eder. Ülke her planda dahildir.

Tüm çalışma alanı için temel sayılar: tüm zamanlardaki ve seçilen aralıktaki tıklamalar, tekil ziyaretçiler, QR taramaları, en yoğun gün ve günün saatine ve haftanın gününe göre dağılımlar. days parametresini kabul eder (varsayılan 30, saklama sürenizle sınırlıdır).

{
  "data": {
    "window_days": 30,
    "clicks": {
      "total": 24592, "window": 8140, "last_7_days": 2103,
      "daily_average": 271,
      "peak_day": { "date": "Sep 02", "clicks": 612 }
    },
    "visitors": { "unique_total": 18204, "unique_window": 6021 },
    "qr": { "scans_total": 940, "scans_window": 310 },
    "timing": {
      "by_hour": [12, 4, 2, …],
      "by_weekday": [1420, 1610, 1585, 1490, 1310, 480, 245],
      "peak_hour": { "peakHour": 14, "peakValue": 812, "label": "14:00–14:59" },
      "peak_weekday": { "peakDay": 1, "peakValue": 1610, "label": "Tuesday" }
    },
    "links": { "active": 42, "limit": 200 }
  },
  "meta": { "plan": "growth", "geo_included": true, "retention_days": 365 }
}

Grafiğe hazır günlük tıklama sayıları. Tek bir bağlantıyla sınırlamak için link_id, aralığı belirlemek için days gönderin. Trafik olmayan günler atlanmak yerine sıfır olarak döndürülür; böylece seri her zaman kesintisizdir.

{
  "data": [
    { "date": "Sep 04", "clicks": 22 },
    { "date": "Sep 05", "clicks": 11 }
  ],
  "meta": { "window_days": 7, "total": 33, "link_id": null }
}

Tek bir boyuta göre gruplanmış tıklamalar ve her satırın toplamdaki payı.

Sorgu parametreleri

• dimension string

  channel, referrer, device, browser, os, brand, variation veya country. browser, os, brand ve variation için link_id gerekir.

  Gerekli
• link_id integer

  Tek bir bağlantıyla sınırlayın. Tüm çalışma alanı için boş bırakın.

  İsteğe bağlı
• limit integer

  1–100. Varsayılan 10.

  İsteğe bağlı

{
  "data": [
    { "label": "Search", "value": 215, "share": 33.1 },
    { "label": "Social", "value": 201, "share": 30.9 },
    { "label": "Direct / none", "value": 142, "share": 21.8 }
  ],
  "meta": { "dimension": "channel", "link_id": 49, "total": 650 }
}

Panelin tek bir bağlantı için gösterdiği her şey tek bir çağrıda: bağlantının kendisi, tıklama toplamları, benzersiz ve geri dönen ziyaretçiler, günlük seri, saat ve hafta günü dağılımları, tüm dağılımlar ve bağlantı bir A/B testi çalıştırıyorsa test sonuç tablosu.

"split_test": {
  "active": true,
  "conclusive": true,
  "minClicks": 100,
  "leader": "control",
  "totalClicks": 650,
  "totalVisitors": 172,
  "arms": [
    { "name": "control", "isControl": true, "weight": 2,
      "clicks": 357, "visitors": 60,
      "expectedShare": 50.0, "actualShare": 54.9, "drift": 4.9 },
    { "name": "variant-b", "isControl": false, "weight": 1,
      "clicks": 146, "visitors": 57,
      "expectedShare": 25.0, "actualShare": 22.5, "drift": -2.5 }
  ]
}

Çalışma alanındaki tüm bağlantıların ham ziyaret akışı, en yeniden eskiye. Bu, GET /visits uç noktasının modern karşılığıdır: aynı veriler, standart zarf, limit ve offset desteği.

{
  "data": [
    {
      "id": 2691,
      "link_id": 49,
      "short_code": "spring",
      "occurred_at": "2026-09-10T22:45:33+00:00",
      "ip_address": "203.0.113.7",
      "referrer": "https://twitter.com/",
      "browser": "Chrome",
      "os": "iOS",
      "device_type": "mobile",
      "device_brand": "Apple",
      "country": "US",
      "variation": "control"
    }
  ],
  "meta": { "limit": 50, "returned": 50, "geo_included": true }
}

Bu hesapta kayıtlı webhook uç noktaları.

Kaydedilen her tıklamada bir JSON yükü almak için bir HTTPS uç noktası kaydedin. Hesap başına en fazla 25. Başarısız teslimatlar otomatik olarak yeniden denenir.

JSON gövdesi

• target_url

  https:// olmalıdır.

  Gerekli
• event

  Varsayılan link_visited; şu anda tek olay budur.

  İsteğe bağlı

curl -X POST https://letl.ink/api/v1/hooks \
  -H "X-API-KEY: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_url": "https://example.com/hooks/clicks"}'

Bir webhook uç noktasını kaldırın. POST /hooks/subscribe ve DELETE /hooks/unsubscribe/{id}, Zapier'in REST Hook akışı için kullanılabilir olmaya devam eder.

Orijinal bağlantı testi: kullanıcı kimliğinizi, e-postanızı ve çalışma alanı kimliğinizi/adınızı düz bir nesne olarak döndürür. GET /me aynı kimliği plan sınırlarınız ve özellik işaretlerinizle birlikte döndürür ve yeni kodlar için daha iyi bir seçimdir.

curl -H "X-API-KEY: YOUR_TOKEN" \
  https://letl.ink/api/v1/auth/me

{
  "id": 1,
  "email": "[email protected]",
  "workspace_id": 12,
  "workspace_name": "My Workspace"
}

Kimlik yerine domain ve slug ile belirtilen tek bir bağlantının tıklama toplamları. Her iki parametre de zorunludur. Kimliği biliyorsanız GET /links/{id} ve GET /analytics/links/{id} aynı işi görür.

Sorgu parametreleri

• domain string

  Ana alan adı veya doğrulanmış özel alan adlarınızdan biri.

  Gerekli
• slug string

  Başında eğik çizgi olmadan kısa kod.

  Gerekli
• start_date date

  YYYY-MM-DD, planınızın saklama süresine göre kırpılır.

  İsteğe bağlı
• end_date date

  YYYY-MM-DD, dahil.

  İsteğe bağlı

Çalışma alanındaki en son 50 ziyaret, yalın bir JSON dizisi olarak — zarf olmadan — visit_id, visit_time, link_shortcode ve visitor_* alan adlarıyla. Zapier'in REST Hook "perform list" adımı bunu okur; bu nedenle yapısı sabittir. Yeni geliştirmeler için GET /events kullanın.

Tek bir bağlantıya yapılan en son 50 ziyaret; created_at, ip_address, country, device_type, browser, os ve referrer içeren yalın bir dizi olarak. /visits ile birlikte sabitlenmiştir; yeni geliştirmeler için GET /links/{id}/events kullanın.

REST Hook aboneliği. target_url ve isteğe bağlı bir event (varsayılan link_visited) alır ve oluşturulan aboneliği zarf olmadan, düz biçimde döndürür. POST /hooks standart biçimdeki aynı işlemdir.

REST Hook abonelikten çıkma; {"success": true} döndürür. DELETE /hooks/{id} standart biçimdeki karşılığıdır.