Bio sayfaları

Bio sayfası, bir bağlantı yığınını barındıran tek bir mobil öncelikli açılış sayfasıdır. Linktree’nin Instagram, TikTok ve X için “bio’daki bağlantı” olarak popülerleştirdiği biçimdir. Her sayfa bio.elido.app/<username> adresinde yaşar (bio sayfaları için özel alan adları planlanmıştır, henüz kullanılamaz) ve bio-renderer tarafından sunucu tarafında oluşturulur; böylece ilk boyamada yüklenir.

Bio sayfaları kısa bağlantılardan bağımsızdır: kendi URL ad alanları, kendi tıklama akışları ve kendi analitikleri vardır.

Sayfa oluşturma

curl -X POST \
  https://api.elido.app/v1/workspaces/1/bio \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "acme",
    "display_name": "Acme Inc.",
    "bio": "We make sprockets that just work.",
    "avatar_url": "https://cdn.example.com/avatar.png",
    "is_published": true,
    "theme": {
      "bg_color": "#0f172a",
      "text_color": "#f8fafc",
      "button_style": "rounded",
      "button_color": "#5b6cff",
      "button_radius": 12
    }
  }'

Bağlantı ekleme

curl -X POST \
  https://api.elido.app/v1/workspaces/1/bio/9/links \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Latest blog post",
    "url": "https://example.com/blog/sprocket-3",
    "icon": "rss",
    "sort_order": 0
  }'

sort_order artan sırada görüntüleme sırasını belirler; her bağlantıda PATCH ile yeniden dengeleyin ya da panonun sürükle-bırak özelliğini kullanın. Simgeler Lucide adlarıdır (rss, youtube, instagram, …).

Herkese açık görüntüleme

Sayfanın kendisi bio-renderer servisinden gelir:

GET https://bio.elido.app/acme

Oluşturucu her istekte GET /v1/bio/acme (herkese açık, kimlik doğrulamasız) çağrısını yapar ve kullanıcı adına göre 60 saniye önbelleğe alır.

Tıklama izleme

Her düğmede “ateşle ve unut” türünde bir izleyici vardır:

navigator.sendBeacon(
  "https://api.elido.app/v1/bio/acme/click",
  JSON.stringify({ link_id: 17 })
);

Oluşturucu bunu otomatik olarak bağlar; JavaScript’i kendiniz eklemezsiniz. Uç nokta Country, User-Agent ve Referer değerlerini kaydeder, ardından kısa bağlantı tıklamalarıyla aynı click-ingester hattı üzerinden ClickHouse’a dağıtır.

Isı haritası

Bağlantı başına tıklama toplamları pano ısı haritasını besler:

curl https://api.elido.app/v1/workspaces/1/bio/9/heatmap \
  -H "Authorization: Bearer $ELIDO_TOKEN"

[
  { "bio_link_id": 17, "clicks": 4321 },
  { "bio_link_id": 18, "clicks": 1187 }
]

Pano bunu sort_order sırasına göre yatay bir çubuk grafik olarak gösterir; böylece hangi bağlantıların işe yaradığını ve hangilerinin ölü olduğunu bir bakışta görürsünüz.

Uç nokta başvurusu