API belgeleri

Create an API key in your account, then call LinkBit with x-api-key or Authorization: Bearer. Public docs never show your keys.

Nasıl kullanılır

REST API

Her istekte x-api-key veya Authorization: Bearer slk_... gönderin.

x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

İstek örnekleri

▸URL kısalt (tek)

Tek kısa bağlantı. Özel slug isteğe bağlı (harf, rakam, tire, en az 1 karakter).

curl -X POST https://linkbit.live/api/v1/links \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"destination": "https://example.com/long-url", "slug": "my-link", "utm_source": "newsletter"}'

▸Toplu kısaltma (planda en fazla 100)

Bir istekte birden fazla oluşturun. Hatalar errors içinde döner; geçerli olanlar yine oluşur.

curl -X POST https://linkbit.live/api/v1/links/bulk \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"urls": [
    {"destination": "https://example.com/page1"},
    {"destination": "https://example.com/page2", "slug": "my-custom-slug"}
  ]}'

▸Bağlantıları listele

Bu API anahtarının tüm kısa bağlantılarını, en yeniden, shortUrl ve tıklamalarla döner.

curl https://linkbit.live/api/v1/links \
  -H "x-api-key: YOUR_API_KEY"

▸Tıklama istatistikleri

Oluşturma veya listedeki id’yi kullanın. Tıklama, tekil, ülke, cihaz, yönlendiren, günlük döner.

curl "https://linkbit.live/api/v1/links/LINK_ID/stats?from=2026-01-01&to=2026-01-31" \
  -H "x-api-key: YOUR_API_KEY"

▸Analitik özeti

Hesap özeti: en iyi bağlantılar, günlük, ülkeler, cihazlar, yönlendirenler.

curl https://linkbit.live/api/v1/analytics \
  -H "x-api-key: YOUR_API_KEY"

Alanlar

Alan	Nerede	Notlar
destination	create / bulk	Zorunlu. http(s) URL. Diğer ad: url
slug	create / bulk	İsteğe bağlı. a-z, 0-9, tire. En az 1 karakter. Boşluklar tire olur.
utm_source … utm_content	create / bulk / CSV	Optional. Stored on the destination URL. Existing utm_* query params are not overwritten. Hash fragments are kept.
urls	bulk body	Bağlantı dizisi. Diğer ad: links
created / errors	bulk response	Başarılı satırlar ve öğe hataları (index, message).

Kimlik hataları 401. Geçersiz girdi 400. Eksik istatistik id 404.