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.

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.



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.
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.
Kısa kod
Kriptografik rastgele üretilen 7 karakterlik kod. Çakışma olursa yeni kodla yeniden denenir.
Yönlendirme
302 ile hedef adrese gidilir, yanıt önbelleğe alınmaz.
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.
# 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.


Ü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.
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.