GeoIP Service, IP adresi, alan adı ya da tam URL verildiğinde tek bir inceleme akışında anlamlı teknik çıktı üreten bir Next.js uygulaması. Amaç, IP konumu, ISP sinyalleri, DNS cevabı, HTTP davranışı ve TLS detaylarını ayrı araçlara bölmeden aynı yerde sunmak.
Neyi çözüyor?
IP sorgulama, web sitesi inceleme ve teknik doğrulama işleri çoğu zaman farklı servisler arasında parçalanıyor. Bu proje, operasyon, destek ve güvenlik incelemelerinde en sık bakılan sinyalleri tek bir yanıt ve tek bir arayüz altında topluyor.
Ana kullanım modları
IP inceleme
- Geçerli istemci IP’sini ya da verilen IPv4/IPv6 adresini analiz eder
- Ülke, bölge, şehir, saat dilimi ve koordinat verisini çıkarır
- ASN, organizasyon, proxy, barındırma ve mobil bağlantı sinyallerini gösterir
- İstek başlıklarından cihaz, tarayıcı ve bağlantı bağlamı üretir
Web sitesi inceleme
- Alan adı veya tam HTTP/HTTPS URL kabul eder
- DNS çözümleme, yönlendirme zinciri ve HTTP yanıt üstverisini toplar
- TLS sertifika bilgilerini ve temel güvenlik/SEO sinyallerini inceler
- Genel erişime açık olmayan hedefleri daha inceleme başlamadan reddeder
Öne çıkan özellikler
- Tek endpoint altında IP, alan adı ve URL hedeflerini otomatik ayırt eden inceleme akışı
- Swagger UI ile canlı OpenAPI dokümantasyonu
X-RateLimit-*veRetry-Afterbaşlıklarıyla bellek içi hız sınırlama- Arayüzle birebir uyumlu, JSON odaklı API yanıt yapısı
- İsteğe bağlı Turso kayıtlarıyla sorgu geçmişi ve son çözümlenen IP kayıtları
- GeoIP verisi eksik olduğunda da tanı üretmeye devam eden geri dönüş davranışı
Bağlantılar
- Canlı uygulama: ip.aliyilmaz.co
- Swagger UI: ip.aliyilmaz.co/docs
- OpenAPI JSON: ip.aliyilmaz.co/api/swagger
- GitHub deposu: github.com/aliyilmazco/geoip-service
Kısa örnekler
# Geçerli istemci IP'sini analiz et
curl https://ip.aliyilmaz.co/api/lookup
# Belirli bir IP adresini analiz et
curl "https://ip.aliyilmaz.co/api/lookup?target=8.8.8.8"
# Bir alan adını analiz et
curl "https://ip.aliyilmaz.co/api/lookup?target=example.com"
# Tam URL ile web sitesi incelemesi çalıştır
curl "https://ip.aliyilmaz.co/api/lookup?target=https://openai.com"
Teknik notlar
- Uygulama Next.js ve TypeScript ile geliştirildi
- GeoIP, istek çözümleme, web sitesi analizi ve yanıt biçimleme tek repo içinde tutuldu
- Dokümantasyon
/api/swaggerüzerinden üretiliyor ve/docsiçinde gömülü Swagger UI olarak sunuluyor - Proje, yerel geliştirmede ve canlı dağıtımda aynı inceleme modelini koruyacak şekilde tasarlandı