tkla.tr URL Kısaltma Servisi

Kendi ürünümüz: uzun bağlantıyı kayıt olmadan kısaltan, geliştiricilere ücretsiz API anahtarı veren, şifresiz yönetim paneliyle çalışan ve bunu uzay temalı bir arayüzle yapan bağlantı kısaltma servisi.

Proje

Kısa bağlantı; SMS'te, e-postada, basılı bir broşürde ya da QR kodda uzun ve karmaşık bir adresin yerini alır. Bunun için yabancı bir servise bağlı kalmak yerine, Türkçe, sade ve hızlı bir servisi kendimiz yazmak istedik. tkla.tr böyle doğdu.

Servis iki ihtiyaca birden cevap veriyor. Ziyaretçi adresi yapıştırıp kısasını hemen alıyor; hesap, e-posta ya da reklam yok. Kendi uygulamasından bağlantı üretmek isteyen geliştirici ise ücretsiz bir API anahtarı alıyor ve hiç düşmeyen, tıklanma sayısını izleyebildiği bağlantılar üretiyor.

tkla.tr · Ana sayfa
tkla.tr ana sayfası: yıldızlı uzay arka planında astronot, gezegen ve roket çizimleri; ortada cam görünümlü kısaltma kartı ve API anahtarı düğmesi

Kısalt, kopyala, roket kalksın

Arayüz tek bir iş için tasarlandı: adresi yapıştırıp kısasını almak. Arka planda fareyle derinliği değişen, üç boyutlu izdüşümle çizilmiş bir yıldız alanı ve ara sıra kayan yıldızlar var. Bağlantı kısaldığında köşedeki roket fırlıyor. Hareketin azaltılmasını tercih eden kullanıcılarda animasyonlar duruyor. Hiçbir çerçeve ya da CDN kullanılmadı; çizimler dahil her şey elle yazılmış HTML, CSS ve JavaScript.

tkla.tr · Kısaltma sonucu
Kısaltma sonrası tkla.tr: kısa bağlantı, kopyala düğmesi ve 30 günlük süre açıklaması; sağda fırlayan roket
Kısa bağlantı tek tıkla kopyalanır; altında bağlantının ne zaman düşeceği yazar. Sağda, başarılı kısaltmada fırlayan roket.
tkla.tr · API anahtarı başvurusu
API anahtarı başvuru penceresi: üç adımda süreç anlatımı, örnek istek bölümü, ad ve e-posta alanları
API başvurusu: ad ve e-posta yeterli. Anahtar yalnızca e-postayla gelir, ekranda hiç gösterilmez.
Panel · Tek kullanımlık kod
Yönetim paneli girişi: kayıtlı e-postaya gönderilen 6 haneli tek kullanımlık kod için altı ayrı kutu
Panele şifreyle girilmez: API anahtarı yazılır, kayıtlı e-postaya 6 haneli tek kullanımlık kod gider.

Görüntülerdeki bağlantılar, firma adları ve e-posta adresleri örnektir.

Kullanıldıkça yaşayan bağlantılar

Ana sayfadan üretilen bağlantıların ömrü sabit değil, kayan bir süre: her tıklamada 30 gün baştan başlıyor. Trafiği olan bağlantı süresiz yaşıyor, 30 gün boyunca hiç açılmayan bağlantı düşüyor. Böylece kayıt istemeden hizmet verirken, unutulmuş binlerce bağlantı veritabanında birikmiyor. API ile üretilen bağlantılar bu kuraldan muaf.

Süre kontrolü yönlendirme sorgusunun kendisinde yapılıyor; temizlik gecikse bile süresi dolmuş bir bağlantı yönlendirmiyor. Tıklanma sayısının artması ve sürenin yenilenmesi aynı istekte, tek bir güncellemeyle oluyor. Süresi dolan kayıtları arka planda saatte bir çalışan bir servis siliyor.

Yönlendirme bilinçli olarak kalıcı (301) değil, geçici (302) yapılıyor. Tarayıcılar 301'i süresiz önbelleğe alır; sonraki tıklamalar sunucuya hiç uğramaz. O zaman tıklanmalar sayılamaz, süre yenilenmez, silinen bir bağlantı da yönlendirmeye devam eder.

  1. Doğrulama

    Yalnızca http ve https adresleri, en fazla 2.048 karakter. tkla.tr'nin kendi adresi, sonsuz döngü yaratmasın diye kısaltılamaz.

  2. Kısa kod

    Kriptografik rastgele üretilen 7 karakterlik kod. Çakışma olursa yeni kodla yeniden denenir.

  3. Yönlendirme

    302 ile hedef adrese gidilir, yanıt önbelleğe alınmaz.

  4. Süre yenileme

    Tıklanma sayılır ve 30 günlük süre aynı anda baştan başlar.

Geliştiriciler için: anahtar yalnızca e-postayla

API anahtarı almak için ad ve e-posta adresi bırakmak yeterli. Anahtar HTTP yanıtında hiçbir zaman dönmüyor, yalnızca e-postayla gönderiliyor. Böylece anahtarı yalnızca adresin gerçek sahibi alabiliyor ve ayrı bir doğrulama adımına gerek kalmıyor. Gelen e-posta aynı zamanda bir kullanım kılavuzu: hızlı başlangıç, tüm uçlar, hata kodları, sınırlar ve cURL, C#, JavaScript ve PHP örnekleri.

Bir e-posta adresine tek aktif anahtar veriliyor. Aynı adresle yeniden başvurulursa mevcut anahtar değiştirilmiyor, sahibine bilgilendirme e-postası gidiyor; aksi halde adresi bilen biri başkasının anahtarını geçersiz kılabilirdi. Başvurunun yanıtı her durumda aynı, bir adresin kayıtlı olup olmadığı dışarıdan anlaşılmıyor. E-posta gönderilemezse anahtar kaydı geri alınıyor.

Veritabanında anahtarın kendisi değil, yalnızca SHA-256 özeti ve tanıma öneki tutuluyor. Anahtarla üretilen bağlantılar süresiz; her biri için tıklanma sayısı ve son erişim zamanı sorgulanabiliyor, istenirse bağlantı devre dışı bırakılabiliyor.

Terminal · tkla.tr API
# Süresiz kısa link
curl -X POST https://tkla.tr/api/v1/shorten \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://ornek.com/urun/12345"}'

# { "shortUrl": "https://tkla.tr/Q7z1", "isPermanent": true }

# Tıklanma sayısı ve son erişim
curl https://tkla.tr/api/v1/urls/Q7z1 \
  -H "Authorization: Bearer sk_live_…"

Şifresiz yönetim paneli ve premium

Anahtar sahipleri bağlantılarını panelden yönetiyor. Girişte şifre yok: API anahtarı yazılıyor, kayıtlı e-postaya 10 dakika geçerli, 6 haneli bir kod gidiyor. Kod başına 5 deneme hakkı var; oturum 12 saat sürüyor ve tarayıcıda JavaScript'in okuyamadığı bir çerezde tutuluyor. Veritabanında ne kod ne oturum, yalnızca özetleri saklanıyor.

Panel · Linklerim
Premium kullanıcının paneli: yeni link kısaltma alanında özel kod kutusu, tıklanma sayıları, oluşturma tarihleri ve süresiz etiketli bağlantı listesi
Premium kullanıcı kısaltırken kendi kodunu seçebiliyor (tkla.tr/kampanya gibi) ve mevcut bir bağlantının kodunu sonradan değiştirebiliyor.
Panel · Yönetici görünümü
Yönetici paneli: API anahtarları tablosunda sahip, e-posta, link sayısı, durum ve premium anahtarı
Yönetici bütün anahtarları ve bağlantıları görüyor; bir anahtarı tek dokunuşla premium yapabiliyor.

Ücretsizden premiuma

Ücretsiz kullanıcı premium özellikleri panelde kilitli olarak görüyor. Kilide dokunduğunda bir başvuru penceresi açılıyor; adını, telefonunu ve e-postasını bırakıyor, başvuru yöneticiye e-postayla düşüyor.

Özel kodlar 3 ile 30 karakter arasında olabiliyor. "api", "panel" gibi sistemin kendi adresleriyle çakışacak sözcükler ayrılmış durumda. Aynı kodu iki kişinin aynı anda alması veritabanı düzeyinde engelleniyor.

Tahmin edilemez, kötüye kullanılamaz

Birçok kısaltma servisi kodu sıra numarasından üretir: art arda kısaltılan bağlantılar birbirini izleyen kodlar alır, kodu bir artırarak başkalarının bağlantıları gezilebilir. tkla.tr'de kayıt numarası veritabanı sırasından gelse de kısa kod ondan türetilmiyor; 62 karakterli alfabeden kriptografik rastgele seçilen 7 karakter, yaklaşık 3,5 trilyon olasılık demek.

Her uç kendi sınırıyla korunuyor: ana sayfadan kısaltma IP başına dakikada 10, API anahtar başına dakikada 60 istek. Anahtar başvurusu IP başına saatte 3, panel girişi saatte 5 ile sınırlı; böylece servis başkalarının adresine e-posta yağdırmak için kullanılamıyor. Yönlendirme ucu ise bilinçli olarak sınırsız, çünkü asıl trafik orada.

Loglarda e-posta adresleri maskeleniyor; anahtarlar ve giriş kodları hiçbir zaman loglanmıyor. Silinen bir bağlantının kaydı yok edilmiyor, pasife alınıyor.

Rakamlarla

Olası otomatik kod
3,5 trilyon
Kullanılmayan linkin ömrü
30 gün
Panel girişinde şifre
Yok
Arayüzdeki harici kütüphane
0

Otomatik kodlar 7 karakterlidir: 62⁷ ≈ 3,5 trilyon. API ile üretilen bağlantıların süresi dolmaz.

Ana özellikler

Kısaltma

  • Kayıt gerektirmeyen kısaltma
  • 30 gün kayan ömür
  • Kriptografik rastgele 7 karakterlik kod
  • 302 yönlendirme ve tıklanma sayacı

API

  • Bearer anahtarla süresiz bağlantı
  • Tıklanma ve son erişim sorgusu
  • Bağlantıyı devre dışı bırakma
  • Kılavuz niteliğinde karşılama e-postası

Panel

  • E-postaya kodla şifresiz giriş
  • Bağlantı listesi ve kopyalama
  • Premium: özel ve değiştirilebilir kod
  • Yönetici: anahtar ve premium yönetimi

Güvenlik

  • Anahtar ve oturumlar yalnızca özetiyle
  • Uç bazında istek sınırları
  • Kayıtlı adresi ele vermeyen yanıtlar
  • Maskelenmiş loglar

Arayüz

  • Canvas ile 3B yıldız alanı
  • Fare paralaksı ve kayan yıldızlar
  • Elle çizilmiş SVG astronot, roket ve gezegen
  • Hareket azaltma tercihine uyum

Teknoloji

  • .NET 10 ve C#
  • ASP.NET Core Minimal API
  • Entity Framework Core
  • SQL Server
  • Serilog ve xUnit
  • Saf HTML, CSS ve JavaScript

tkla.tr, küçük bir aracın da büyük sistemlerle aynı özenle tasarlanması gerektiğine inanmamızın örneği.

tkla.tr'yi deneyin

Deadline'ınızı söyleyin, planı birlikte çıkaralım.

Uzman ekibimiz sizinle iletişime geçmek için hazır. Araya bürokrasi girmez; doğrudan işi yapacak ekiple konuşursunuz.